الفرق بين المراجعتين ل"Ruby/TracePoint/enable"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>enable‎</code> الخاص بالصنف <code>TracePoint</code> في روبي}}</noinclude> تصنيف: Ruby تص...')
 
ط (مراجعة وتدقيق.)
 
(مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع <code>enable‎</code> الخاص بالصنف <code>TracePoint</code> في روبي}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: التابع <code>TracePoint.enable‎</code> في روبي}}</noinclude>
 
[[تصنيف: Ruby]]
 
[[تصنيف: Ruby]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby TracePoint]]
 
[[تصنيف: Ruby TracePoint]]
ينشط التابع <code>enable</code> التعقب.
+
يفعِّل التابع <code>enable</code> التعقب. في حال إعطاء كتلة لهذا التابع، فلن يُنشّط التعقب إلا في نطاق تلك الكتلة.
 
 
يُعيد true إن أُتيح التعقب. أو يعيد false إذا تم تعطيله.
 
 
 
 
 
 
 
في حال إعطاء كتلة، فلن يُنشّط التعقب إلا في نطاق تلك الكتلة.
 
 
 
 
 
 
 
ملاحظة: لا يمكنك الوصول إلى خطافات الأحداث (event hooks) داخل الكتلة.
 
 
==البنية العامة==
 
==البنية العامة==
 
<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> إذا كان معطَّلًا مسبقًا.
مثال على استخدام التابع <code>enable‎</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 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‎ في توثيق روبي الرسمي.]

المراجعة الحالية بتاريخ 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?‎: يتحقق من الوضع الحالي للتعقب.

مصادر