التابع 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__‎‎‎: يستدعي تابعًا محددًا مع تمرير وسائط إليه.

مصادر

• قسم التابع instance_eval في الصنف BasicObject في توثيق روبي الرسمي.