الفرق بين المراجعتين لصفحة: «Ruby/TracePoint/enable»

المراجعة الحالية بتاريخ 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

انظر أيضًا

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

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع <code>enable‎</code> الخاص بالصنف <code>TracePoint</code> في روبي}}</noinclude>
+<noinclude>{{DISPLAYTITLE: التابع <code>TracePoint.enable‎</code> في روبي}}</noinclude>
 [[تصنيف: Ruby]]
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby TracePoint]]
-ينشط التابع <code>enable</code> التعقب.
+يفعِّل التابع <code>enable</code> التعقب. في حال إعطاء كتلة لهذا التابع، فلن يُنشّط التعقب إلا في نطاق تلك الكتلة.
-يُعيد true إن أُتيح التعقب. أو يعيد false إذا تم تعطيله.
-في حال إعطاء كتلة، فلن يُنشّط التعقب إلا في نطاق تلك الكتلة.
-ملاحظة: لا يمكنك الوصول إلى خطافات الأحداث (event hooks) داخل الكتلة.
 ==البنية العامة==
 <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
+== أمثلة ==
+مثال على استعمال التابع <code>enable</code>:<syntaxhighlight lang="ruby">trace.enabled?  #=> false
 trace.enable    #=> false (previous state)
                  #   trace is enabled
 trace.enabled?  #=> true
 trace.enable    #=> true (previous state)
-                 #   trace is still enabled‎</syntaxhighlight>
+                 #   trace is still enabled</syntaxhighlight>مثال آخر على استعمال التابع <code>enable</code> مع تمرير كتلة:<syntaxhighlight lang="ruby">trace.enabled?
-==انظر أيضا==
+#=> false
-* التابع <code>[[Ruby/TracePoint/disable|disable]]</code>: يعطل التابع <code>disable</code> التعقب.
-* التابع <code>[[Ruby/TracePoint/enabled-3F|enabled?‎]]</code>: يت[https://ar.wikipedia.org/wiki/%D8%AA%D9%88%D9%82%D9%8A%D8%AA_%D9%8A%D9%88%D9%86%D9%83%D8%B3 حقبة يونيكس] التابع <code>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 قسم  التابع enable‎ في الصنف TracePoint‎ في توثيق روبي الرسمي.]
+*[http://ruby-doc.org/core-2.5.1/TracePoint.html#method-i-enable قسم التابع enable‎ في الصنف TracePoint‎ في توثيق روبي الرسمي.]