الدالة get_object_vars()‎‎‎‎ في PHP

(PHP 4, PHP 5, PHP 7)

تحصل الدالة get_object_vars()‎‎‎ على خصائص (properties) الكائن المُعطى.

الوصف

 array get_object_vars ( object $object )

تحصل الدالة get_object_vars()‎‎‎ على الخصائص غير الساكنة التي يمكن الوصول إليها للكائن المُعطى وفقًا للنطاق.

المعاملات

object

الكائن الذي نريد الحصول على خصائصه.

القيم المعادة

تُعيد الدالة get_object_vars()‎‎‎ مصفوفة ترابطية لخصائص كائن مُعرّفة غير ساكنة قابلة للوصول لكائن مُحدد object  في نطاق. إذا لم تُسند قيمة إلى خاصيةٍ ما، فستُعيد الدالة get_object_vars()‎ القيمة NULL.

سجل التغييرات

الاصدار	الوصف
5.3.0	تُعيد هذه الدالة الآن NULL إذا لم يكن كائنًا (أي من النوع object). سابقاً كانت تُعاد القيمة FALSE.

أمثلة

المثال 1: مثال عن استخدام الدالة get_object_vars()‎

<?php
class foo {
    private $a;
    public $b = 1;
    public $c;
    private $d;
    static $e;
   
    public function test() {
        var_dump(get_object_vars($this));
    }
}

$test = new foo;
var_dump(get_object_vars($test));

$test->test();

?>

سينتج المثال السابق الناتج الآتي:

 array(2) {
  ["b"]=>
  int(1)
  ["c"]=>
  NULL
}
array(4) {
  ["a"]=>
  NULL
  ["b"]=>
  int(1)
  ["c"]=>
  NULL
  ["d"]=>
  NULL
}

انظر أيضًا

• الدالة get_class_methods()‎: الحصول على أسماء الدوال التابعة لصنف.
• الدالة get_class_vars()‎‎‎: الحصول على الخصائص الافتراضية لصنف.

مصادر

• صفحة الدالة get_object_vars‎ في توثيق PHP الرسمي.