عرض مصدر Ruby/TracePoint/new

<noinclude>{{DISPLAYTITLE: التابع <code>new‎</code> الخاص بالصنف <code>TracePoint</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby TracePoint]]
يُعيد التابع <code>new</code> [[Ruby/TracePoint|متعقب]]ا<code>[[Ruby/TracePoint|TracePoint]]</code> جديدًا، غير متاح افتراضيا.

من أجل إتاحة التعقب، يجب عليك استخدام <code>[[Ruby/TracePoint/enable|#enable]]</code>



إن أردت إلغاء التعقب، عليك استخدام <code>[[Ruby/TracePoint/disable|#disable]]</code>



راجع صفحة <code>[[Ruby/TracePoint/label-Events|Events at TracePoint]]</code> للتعرف على الأحداث الممكنة ولمزيد من المعلومات.

يجب إعطاء كتلة، وإلا سيُطلق <code>[[Ruby/ArgumentError|ArgumentError]]</code>.

إذا لم يتم تضمين التابع trace في مرشح الأحداث المعطاة، سيُطلق الاستثناء <code>[[Ruby/RuntimeError|RuntimeError]]</code>.



إذا تم استدعاء التابع trace خارج كتلة، فسيُطلق <code>[[Ruby/RuntimeError|RuntimeError]]</code>.



كما يُحظر الدخول من [[Ruby/Thread|المهام الفرعية]].
==البنية العامة==
<syntaxhighlight lang="ruby">new(*events) { |obj| block } → obj‎</syntaxhighlight>
==المعاملات==
===<code>events‎</code>===
==القيمة المُعادة==
==أمثلة==
مثال على استخدام التابع <code>new‎</code>:
<syntaxhighlight lang="ruby">trace = TracePoint.new(:call) do |tp|
    p [tp.lineno, tp.defined_class, tp.method_id, tp.event]
end
#=> #<TracePoint:disabled>
trace.enable
#=> false
puts "Hello, TracePoint!"
# ...
# [48, IRB::Notifier::AbstractNotifier, :printf, :call]
# ...‎</syntaxhighlight>
==انظر أيضا==
* التابع <code>[[Ruby/TracePoint/stat|stat]]</code>: يُعيد التابع <code>stat</code> المعلومات الداخلية لل[[Ruby/TracePoint|متعقب]] <code>[[Ruby/TracePoint|TracePoint]]</code>.
==مصادر==
*[http://ruby-doc.org/core-2.5.1/TracePoint.html#method-c-new قسم  التابع new‎ في الصنف TracePoint‎ في توثيق روبي الرسمي.]