الفرق بين المراجعتين لصفحة: «Ruby/Kernel/set trace func»

مراجعة 16:53، 22 أكتوبر 2018

يجعل التابع set_trace_func الوسيط المعطى proc كمتعقب (handler for tracing)، أو يعطل التعقب إن كان الوسيط يساوي nil.

ملاحظة: هذا التابع صار متجاوزًا، يُرجى استخدام TracePoint بدلاً منه.

يقبل proc ستة وسائط:

اسم حدث
اسم ملف
رقم السطر
معرف كائن (object id)
كائن ربط (binding)
اسم الصنف

يتم استدعاء proc كلما وقع حدث. الأحداث هي كالآتي:

`c-call`	استدعاء C-language routine
`c-return`	العودة من C-language routine
`call`	استدعاء تابع من توابع روبي
`class`	بدء تعريف صنف أو وحدة
`end`	إنهاء بدء تعريف صنف أو وحدة
`line`	تنفيذ كود برمجي على سطر جديد
`raise`	إطلاق استثناء
`return`	العودة من توابع روبي.

يتم تعطيل التعقب في سياق proc.

  class Test
  def test
    a = 1
    b = 2
  end
  end
  set_trace_func proc { |event, file, line, id, binding, classname|
     printf "%8s %s:%-2d %10s %8s\n", event, file, line, id, classname
  }
  t = Test.new
  t.test
    line prog.rb:11               false
  c-call prog.rb:11        new    Class
  c-call prog.rb:11 initialize   Object
c-return prog.rb:11 initialize   Object
c-return prog.rb:11        new    Class
    line prog.rb:12               false
    call prog.rb:2        test     Test
    line prog.rb:3        test     Test
    line prog.rb:4        test     Test
  return prog.rb:4        test     Test‎

البنية العامة

set_trace_func(proc) → proc
set_trace_func(nil)  → nil‎

المعاملات

`proc‎`

يمثل المتعقب المعطى.

انظر أيضا

صفحة الصنف TracePoint.

مصادر

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

@@ سطر 3: / سطر 3: @@
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby Kernel]]
-يجعل التابع set_trace_func الوسيط المعطى proc كمتعقب (handler for tracing)، أو يعطل التعقب إن كان الوسيط يساوي <code>nil</code>.
+يجعل التابع <code>set_trace_func</code> الوسيط المعطى <code>proc</code> كمتعقب (handler for tracing)، أو يعطل التعقب إن كان الوسيط يساوي <code>nil</code>.
-ملاحظة: هذا التابع صار متجاوزًا، يُرجى استخدام <code>TracePoint</code> بدلاً من ذلك.
-يأخذ proc ستة وسائط:
+ملاحظة: هذا التابع صار متجاوزًا، يُرجى استخدام <code>[[Ruby/TracePoint|TracePoint]]</code> بدلاً منه.
-اسم حدث اسم ملف رقم السطر معرف كائن (an object id) كائن ربط (binding) اسم الصنف
-يتم استدعاء proc كلما وقع حدث.
+يقبل <code>proc</code> ستة وسائط:
-الأحداث:
+* اسم حدث
-<code>c-call</code> استدعاء C-language routine <code>c-return</code> العودة من C-language routine <code>call</code> استدعاء تابع من توابع روبي <code>class</code> بدء تعريف صنف أو وحدة <code>end</code> إنهاءبدء تعريف صنف أو وحدة <code>line</code> تنفيذ كود برمجي على سطر جديد <code>raise</code> إطلاق استثناء <code>return</code> العودة من توابع روبع
+* اسم ملف
-يتم تعطيل التعقب في سياق proc.
+* رقم السطر
+* معرف كائن (object id)
+* كائن ربط (binding)
+* اسم الصنف
+يتم استدعاء <code>proc</code> كلما وقع حدث.
+الأحداث هي كالآتي:
+{| class="wikitable"
+|<code>c-call</code>
+|استدعاء C-language routine
+|-
+|<code>c-return</code>
+|العودة من C-language routine
+|-
+|<code>call</code>
+|استدعاء تابع من توابع روبي
+|-
+|<code>class</code>
+|بدء تعريف صنف أو وحدة
+|-
+|<code>end</code>
+|إنهاء بدء تعريف صنف أو وحدة
+|-
+|<code>line</code>
+|تنفيذ كود برمجي على سطر جديد
+|-
+|<code>raise</code>
+|إطلاق استثناء
+|-
+|<code>return</code>
+|العودة من توابع روبي.
+|}
+يتم تعطيل التعقب في سياق <code>proc</code>.
 <syntaxhighlight lang="ruby">  class Test
    def test
@@ سطر 37: / سطر 68: @@
 ==المعاملات==
 ===<code>proc‎</code>===
+يمثل المتعقب المعطى.
-===<code>nil‎</code>===
-==القيمة المُعادة==
 ==انظر أيضا==
-* التابع <code>[[Ruby/Kernel/select|select]]</code>: يستدعي select(2). ويقوم بمراقبة المصفوفة المعطاة المكونة من كائنات <code>IO</code>، وينتظر حتى يكون أحد كائنات <code>IO</code> جاهزًا للقراءة ، وجاهزا للكتابة، ويكون لها استثناءات معلقة (pending exceptions) على التوالي، ثم يعيد مصفوفة تحتوي على مصفوفات مكونة من تلك كائنات <code>IO</code> السابقة.  ستُعاد القيمة <code>nil</code> إذا تم إعطاء قيمة للوسيط الاختياري timeout، ولم يكن هناك أي كائن <code>IO</code> جاهزًا خلال timeout ثانية.
+* صفحة الصنف <code>[[Ruby/TracePoint|TracePoint]]</code>.
-* التابع <code>[[Ruby/Kernel/sleep|sleep]]</code>: يعلّق التابع sleep المهمة الفرعية (thread) الحالية لعدد من الثواني (والذي قد بكون أي عدد، بما في ذلك <code>Float</code> مع كسور ثوان). ثم يعيد عدد الثواني الفعلي (بالتقريب) الذي نامتها المهمة الفرعية، والذي قد يكون أقل من العدد المطلوب إن استدعت مهمة فرعية أخرى <code>Thread#run</code>. في حال استدعائها دون تمرير أي وسيط، ستقوم sleep() بتنويم المهمة الفرعية إلى الأبد.
 ==مصادر==
 *[http://ruby-doc.org/core-2.5.1/Kernel.html#method-i-set_trace_func قسم  التابع set_trace_func‎ في الصنف Kernel‎ في توثيق روبي الرسمي.]