الفرق بين المراجعتين لصفحة: «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