التابع TracePoint.enable‎ في روبي

يفعِّل التابع enable التعقب. في حال إعطاء كتلة لهذا التابع، فلن يُنشّط التعقب إلا في نطاق تلك الكتلة.

البنية العامة

enable→ true or false
enable { block } → obj‎

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

تعاد القيمة true إن كان التعقب مفعَّلًا أو تعاد القيمة false إذا كان معطَّلًا مسبقًا.

أمثلة

مثال على استعمال التابع enable:

trace.enabled?  #=> false
trace.enable    #=> false (previous state)
                #   trace is enabled
trace.enabled?  #=> true
trace.enable    #=> true (previous state)
                #   trace is still enabled

مثال آخر على استعمال التابع enable مع تمرير كتلة:

trace.enabled?
#=> false

trace.enable do
    trace.enabled?
    # only enabled for this block
end

trace.enabled?
#=> false

ملاحظة: لا يمكنك الوصول إلى خطافات الأحداث (event hooks) داخل الكتلة:

trace.enable { p tp.lineno }
#=> RuntimeError: access from outside

انظر أيضًا

• التابع disable: يعطل التعقب.
• التابع enabled?‎: يتحقق من الوضع الحالي للتعقب.

مصادر

• قسم التابع enable‎ في الصنف TracePoint‎ في توثيق روبي الرسمي.