الفرق بين المراجعتين ل"Ruby/TracePoint/enable"
< Ruby | TracePoint
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) ط (مراجعة وتدقيق.) |
|||
سطر 1: | سطر 1: | ||
− | <noinclude>{{DISPLAYTITLE: التابع <code>enable | + | <noinclude>{{DISPLAYTITLE: التابع <code>TracePoint.enable</code> في روبي}}</noinclude> |
[[تصنيف: Ruby]] | [[تصنيف: Ruby]] | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby TracePoint]] | [[تصنيف: Ruby TracePoint]] | ||
− | + | يفعِّل التابع <code>enable</code> التعقب. في حال إعطاء كتلة لهذا التابع، فلن يُنشّط التعقب إلا في نطاق تلك الكتلة. | |
+ | ==البنية العامة== | ||
+ | <syntaxhighlight lang="ruby">enable→ true or false | ||
+ | enable { block } → obj</syntaxhighlight> | ||
+ | ==القيمة المعادة== | ||
+ | تعاد القيمة <code>true</code> إن كان التعقب مفعَّلًا أو تعاد القيمة <code>false</code> إذا كان معطَّلًا مسبقًا. | ||
− | + | == أمثلة == | |
+ | مثال على استعمال التابع <code>enable</code>:<syntaxhighlight lang="ruby">trace.enabled? #=> false | ||
trace.enable #=> false (previous state) | trace.enable #=> false (previous state) | ||
# trace is enabled | # trace is enabled | ||
trace.enabled? #=> true | trace.enabled? #=> true | ||
trace.enable #=> true (previous state) | trace.enable #=> true (previous state) | ||
− | # trace is still enabled</syntaxhighlight> | + | # trace is still enabled</syntaxhighlight>مثال آخر على استعمال التابع <code>enable</code> مع تمرير كتلة:<syntaxhighlight lang="ruby">trace.enabled? |
#=> false | #=> false | ||
سطر 19: | سطر 25: | ||
trace.enabled? | trace.enabled? | ||
− | #=> false</syntaxhighlight>'''ملاحظة''': لا يمكنك الوصول إلى خطافات الأحداث (event hooks) داخل الكتلة | + | #=> false</syntaxhighlight>'''ملاحظة''': لا يمكنك الوصول إلى خطافات الأحداث (event hooks) داخل الكتلة:<syntaxhighlight lang="ruby">trace.enable { p tp.lineno } |
#=> RuntimeError: access from outside</syntaxhighlight> | #=> RuntimeError: access from outside</syntaxhighlight> | ||
− | + | ==انظر أيضًا== | |
− | + | * التابع <code>[[Ruby/TracePoint/disable|disable]]</code>: يعطل التعقب. | |
− | + | * التابع <code>[[Ruby/TracePoint/enabled-3F|enabled?]]</code>: يتحقق من الوضع الحالي للتعقب. | |
− | |||
− | |||
− | |||
− | ==انظر | ||
− | * التابع <code>[[Ruby/TracePoint/disable|disable]]</code>: يعطل | ||
− | * التابع <code>[[Ruby/TracePoint/enabled-3F|enabled?]]</code>: يتحقق | ||
==مصادر== | ==مصادر== | ||
− | *[http://ruby-doc.org/core-2.5.1/TracePoint.html#method-i-enable قسم | + | *[http://ruby-doc.org/core-2.5.1/TracePoint.html#method-i-enable قسم التابع enable في الصنف TracePoint في توثيق روبي الرسمي.] |
المراجعة الحالية بتاريخ 05:42، 8 ديسمبر 2018
يفعِّل التابع 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