الدالة getattr()
في بايثون
< Python
تعيد الدّالة getattr()
قيمة الخاصيّة المُعطاة من الكائن المُعطى.
البنية العامة
getattr(object, name[, default])
المعاملات
object
الكائن المراد الحصول على قيمة خاصيّته.
name
سلسلة نصيّة تُمثّل اسم الخاصيّة المرغوب الوصول إلى قيمتها.
default
مُعامل اختياريّ.
القيمة الافتراضيّة التي ستُعاد إن لم تكن الخاصيّة موجودة.
القيمة المعادة
قيمة الخاصيّة ذات الاسم الذي يوافق المُعامل name
.
إن لم تكن الخاصيّة موجودة فستُعاد قيمة المُعامل default
إن توفّر، أو سيُطلَق خطأ AttributeError
إن لم تتوفّر قيمة للمُعامل.
أمثلة
المثال التّالي يوضّح كيفيّة عمل هذه الدّالة:
>>> class Person:
... name = 'Ali'
...
>>> Person.name # الحصول على قيمة الخاصيّة مُباشرة
'Ali'
>>> getattr(Person, 'name') # الحصول على قيمة الخاصيّة باستخدام الدّالة
'Ali'
ملاحظات
كما تُلاحظ في المثال أعلاه، الاستدعاء getattr(x, 'foobar')
مُكافئ للاستدعاء x.foobar
.