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

يعطل التابع disable التعقب. في حال إعطاء كتلة لهذا التابع، فلن يُعطّل التعقب إلا ضمن نطاق تلك الكتلة.

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

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

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

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

trace.enabled?       #=> true
trace.disable        #=> true (previous status)
trace.enabled?       #=> false
trace.disable        #=> false

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

trace.enabled?
#=> true

trace.disable do
    trace.enabled?
    # only disabled for this block
end

trace.enabled?
#=> true

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

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