التابع instance_eval
في الصنف BasicObject
في روبي
يقدِّر (Evaluates) التابع instance_eval
ناتج تنفيذ شيفرة مصدرية للغة روبي معطاة كسلسلة نصية أو ناتج كتلة برمجية (block) مُمرَّرة ضمن سياق كائن مُستقبِل (obj). لتعيين السياق، يُضبَط المتغير self
إلى obj
أثناء تنفيذ الشيفرة، مما يعطي الشيفرة إمكانية الوصول لمتغيرات النسخة obj
والتوابع الخاصة.
عندما يُمرَّر إلى التابع instance_eval
كتلة برمجية، يُمرَّر obj
أيضاً كوسيط وحيد للكتلة.
البنية العامة
instance_eval(string [, filename [, lineno]] ) → obj
instance_eval {|obj| block } → obj
عندما يُمرَّر إلى التابع instance_eval
سلسلة نصية، يوفر المعاملان filename
و lineno
الاختياريان اسم الملف ورقم سطر البداية اللذان سيُستخدمان عند الإبلاغ عن وجود أخطاء في التصريف (compilation errors).
المعاملات
string
سلسلة نصية تحوي الشيفرة المراد تقدير ناتج تنفيذها.
filename
سلسلة نصية تمثل اسم الملف الذي سيستعمل عند الإبلاغ عن حصول أخطاء في التصريف (compilation errors).
lineno
سلسلة نصية تمثل رقم سطر البداية الذي سيستعمل عند الإبلاغ عن حصول أخطاء في التصريف (compilation errors).
القيم المعادة
يعاد كائن يحوي الناتج التقديري للشيفرة المعطاة في المعامل string
أو الكتلة block
.
أمثلة
مثال على استخدام التابع instance_eval
:
class KlassWithSecret
def initialize
@secret = 99
end
private
def the_secret
"Ssssh! The secret is #{@secret}."
end
end
k = KlassWithSecret.new
k.instance_eval { @secret } #=> 99
k.instance_eval { the_secret } #=> "Ssssh! The secret is 99."
k.instance_eval {|obj| obj == self } #=> true
انظر أيضًا
- التابع
instance_exec
: ينفِّذ الكتلة البرمجية المُمرَّرة ضمن سياق الكائن المستقبل (obj). - التابع
__send__
: يستدعي تابعًا محددًا مع تمرير وسائط إليه.