الفرق بين المراجعتين ل"Ruby/TracePoint/enable"
< Ruby | TracePoint
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>enable</code> الخاص بالصنف <code>TracePoint</code> في روبي}}</noinclude> تصنيف: Ruby تص...') |
جميل-بيلوني (نقاش | مساهمات) ط (مراجعة وتدقيق.) |
||
(مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة) | |||
سطر 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 | <syntaxhighlight lang="ruby">enable→ true or false | ||
enable { block } → obj</syntaxhighlight> | enable { block } → obj</syntaxhighlight> | ||
− | ==القيمة | + | ==القيمة المعادة== |
− | ==أمثلة== | + | تعاد القيمة <code>true</code> إن كان التعقب مفعَّلًا أو تعاد القيمة <code>false</code> إذا كان معطَّلًا مسبقًا. |
− | مثال على | + | |
− | <syntaxhighlight lang="ruby">trace.enabled? #=> false | + | == أمثلة == |
+ | مثال على استعمال التابع <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 | + | # trace is still enabled</syntaxhighlight>مثال آخر على استعمال التابع <code>enable</code> مع تمرير كتلة:<syntaxhighlight lang="ruby">trace.enabled? |
− | ==انظر | + | #=> false |
− | * التابع <code>[[Ruby/TracePoint/disable|disable]]</code>: يعطل | + | |
− | * التابع <code>[[Ruby/TracePoint/enabled-3F|enabled?]]</code>: | + | trace.enable do |
+ | trace.enabled? | ||
+ | # only enabled for this block | ||
+ | end | ||
+ | |||
+ | trace.enabled? | ||
+ | #=> false</syntaxhighlight>'''ملاحظة''': لا يمكنك الوصول إلى خطافات الأحداث (event hooks) داخل الكتلة:<syntaxhighlight lang="ruby">trace.enable { p tp.lineno } | ||
+ | #=> RuntimeError: access from outside</syntaxhighlight> | ||
+ | ==انظر أيضًا== | ||
+ | * التابع <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