نتائج البحث
اذهب إلى التنقل
اذهب إلى البحث
الصنف TracePoint في روبي
يوفر الصنف TracePoint وظائف Kernel.set_trace_func على شكل واجهة برمجية كائنية (Object-Oriented API). مثال يمكننا استخدام المتعقبات (كائنات الصنف TracePoint) لجمع المعلومات بخصوص الاستثناءات: trace = TracePoint.new(:raise) do |tp|
p [tp.lineno, tp.event, tp.raised_exception]
end
#=> #<TracePoint:disabled>
trace.enable
#=> false
0 / 0
#=> [5, :raise, #<ZeroDivisionError: divided by 0>]
الأحداث إذا لم تحدِّد نوع الأحداث التي تريد الاستماع إليها، فسيشمل المتعقب TracePoint جميع الأحداث المتاحة. ملحوظة: لا تعتمد على مجموعة الأحداث الحالية، إذ أن هذه القائمة عرضةٌ للتغيير. بدلًا من ذلك، يُنصَح بتحديد نوع ...
التابع TracePoint.event في روبي
يعيد التابع event نوع الحدث التي يجري تعقبه. راجع صفحة الصنف TracePoint لمزيد من المعلومات حول الأحداث المتاحة. البنية العامة event()
القيمة المعادة يعاد نوع الحدث الذي يجري تعقبه. انظر أيضًا التابع inspect: يُعيد سلسلة نصية تحتوي حالة كائن TracePoint وفق صيغة قابلة للقراءة. مصادر قسم التابع event في الصنف TracePoint في توثيق روبي الرسمي.
التابع TracePoint.inspect في روبي
يُعيد التابع inspect سلسلة نصية تحتوي حالة الكائن TracePoint الذي استُدعي معه وفق صيغة قابلة للقراءة. البنية العامة inspect → string
القيمة المعادة تعاد سلسلة نصية تحتوي حالة كائن TracePoint الذي استُدعي معه وفق صيغة قابلة للقراءة. انظر أيضًا التابع event: يعيد نوع الحدث التي يجري تعقبه. التابع lineno: يعيد رقم سطر الحدث التي يجري تعقبه. مصادر قسم التابع inspect في الصنف TracePoint في توثيق روبي الرسمي.
التابع TracePoint.new في روبي
يُعيد التابع new متعقبًا جديدًا غير مفعَّل افتراضيًّا. راجع صفحة الصنف TracePoint للتعرف على الأحداث الممكنة ولمزيد من المعلومات. يجب إعطاء كتلة للتابع، وإلا سيُطلق الاستثناء ArgumentError. البنية العامة new(*events) { |obj| block } → obj
المعاملات events أحداث يراد إنشاء تعقب لها. القيمة المعادة يعاد متعقبٌ جديدٌ للأحداث events. أمثلة من أجل تفعيل التعقب بعد إنشائه باستعمال التابع new، يجب عليك استخدام التابع enable: 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.stat في روبي
يُعيد التابع stat المعلومات الداخلية للمتعقب. المحتويات المعادة مُتعلقة بالتنفيذ (implementation). وقد تتغير في المستقبل. هذا التابع مخصوص بتصحيح (debugging) الصنف TracePoint نفسه. البنية العامة stat → obj
القيمة المعادة تعاد المعلومات الداخلية للمتعقب. انظر أيضًا التابع new: يُعيد متعقبًا جديدًا. التابع trace: ينشِّط التعقب تلقائيًا. مصادر قسم التابع stat في الصنف TracePoint في توثيق روبي الرسمي.
التابع set_trace_func الخاص بالصنف Kernel في روبي
يجعل التابع set_trace_func المعامل المعطى كمعالج للتعقب، أو يعطل التعقب إن كان الوسيط يساوي nil. ملاحظة: أصبح هذا التابع مهملًا، لذا يُرجى استخدام التابع TracePoint بدلاً منه. يقبل proc ستة معاملات هي: اسم حدث اسم ملف رقم سطر معرف كائن (object id) كائن ربط (binding) اسم صنف يستدعى proc كلما وقع حدث. الأحداث هي: الحدث الوصف c-call استدعاء برنامج فرعي في لغة C. c-return العودة من برنامج فرعي في لغة C. call استدعاء تابع من توابع روبي. class بدء تعريف ...
التابع TracePoint.defined_class في روبي
يُعيد التابع defined_class صنف أو وحدة التابع المُستدعى. class C; def foo; end; end
trace = TracePoint.new(:call) do |tp|
p tp.defined_class #=> C
end.enable do
C.new.foo
end
إذا تم تعريف التابع بواسطة وحدة، فستعاد تلك الوحدة. module M; def foo; end; end
class C; include M; end;
trace = TracePoint.new(:call) do |tp|
p tp.defined_class #=> M
end.enable do
C.new.foo
end
ملحوظة: يُعيد التابع defined_class صنفًا مفردًا (singleton class). وسيط الكتلة السادس في التابع Kernel.set_trace_func يُمرَّر الصنف الأصليً (original class) للكائن عبر الصنف المفرد. هذا أحد الفوارق ...
Ruby/Topics
تثبيت روبي توجد طرائق عدَّة لتنزيل وتثبيت روبي على كل منصة وهي: إمَّا استعمال أنظمة مدير الحزم، أو باستعمال المثبِّتات التلقائية، أو باستعمال مدراء روبي. هنالك طريقة أخرى يمكنك بالتأكيد استعمالها لتثبيت روبي وتصريف شيفراتها وهي بنائها من الشيفرة المصدرية مباشرةً. حول روبي يوفر هذا القسم لمحة سريعة عن لغة روبي ونشأتها، وتطورها، ومزاياها التي انفردت بها عن اللغات الأخرى، والتنفيذات المختلفة التي تملكها. البنية العامة بنية اللغة تعد روبي مزيجًا من اللغات البرمجية التالية: Perl، و Smalltalk، و Eiffel، ...
التابع TracePoint.raised_exception في روبي
يعيد التابع raised_exception قيمة الاستثناء الذي تم إطلاقه في الحدث raise:. البنية العامة raised_exception()
القيمة المعادة تعاد قيمة الاستثناء الذي تم إطلاقه في الحدث raise:. انظر أيضًا التابع path: يعيد مسار الملف الجاري تنفيذه. مصادر قسم التابع raised_exception في الصنف TracePoint في توثيق روبي الرسمي.
التابع TracePoint.callee_id في روبي
يُعيد التابع callee_id اسم الاستدعاء الخاص بالتابع الذي يتم استدعاؤه. البنية العامة callee_id()
القيمة المعادة يعاد اسم الاستدعاء الخاص بالتابع الذي يتم استدعاؤه. انظر أيضا التابع defined_class: يُعيد صنف أو وحدة التابع الذي يتم استدعاؤه. مصادر قسم التابع callee_id في الصنف TracePoint في توثيق روبي الرسمي.
التابع TracePoint.self في روبي
يُعيد التابع self كائن التعقب (trace object) الذي تم إنشاؤه من الحدث. التابع self مشابه للتابع binding. البنية العامة self()
القيمة المعادة يعاد كائن التعقب (trace object) الذي تم إنشاؤه من الحدث. أمثلة مثال على استخدام التابع self: trace.binding.eval('self')
انظر أيضًا التابع return_value: يُعيد قيمة الحدث :return و c_return و b_return. التابع binding: يُعيد كائن الربط (generated binding object) الذي تم إنشاؤه من الحدث. مصادر قسم التابع self في الصنف TracePoint في توثيق روبي الرسمي.
التابع TracePoint.enabled? في روبي
يتحقق التابع enabled? من الوضع الحالي للتعقب. البنية العامة enabled? → true or false
القيمة المعادة تعاد القيمة true إن كان التعقب مفعَّلًا أو تعاد القيمة false إذا كان معطَّلًا. انظر أيضًا التابع enable: يفعِّل التعقب. التابع disable: يعطل التعقب. مصادر قسم التابع enabled? في الصنف TracePoint في توثيق روبي الرسمي.
التابع TracePoint.trace في روبي
ينشِّط التابع trace التعقب تلقائيًا وهو ملائم للتابع new. البنية العامة trace(*events) { |obj| block } → obj
المعاملات events أحداث. أمثلة مثال على استخدام التابع trace: trace = TracePoint.trace(:call) { |tp| [tp.lineno, tp.event] }
#=> #<TracePoint:enabled>
trace.enabled? #=> true
انظر أيضًا التابع stat: يُعيد المعلومات الداخلية للمتعقب. التابع binding: يُعيد كائن الربط (generated binding object) الذي تم إنشاؤه من الحدث مصادر قسم التابع trace في الصنف TracePoint في توثيق روبي الرسمي.
التابع TracePoint.method_id في روبي
يعيد التابع method_id الاسم المعطى ساعة تعريف التابع المُستدعى. البنية العامة method_id()
القيمة المعادة يعاد الاسم المعطى ساعة تعريف التابع المُستدعى. انظر أيضًا التابع lineno: يعيد رقم سطر الحدث. التابع path: يعيد مسار الملف الجاري تنفيذه. مصادر قسم التابع method_id في الصنف TracePoint في توثيق روبي الرسمي.
التابع TracePoint.enable في روبي
يفعِّل التابع enable التعقب. في حال إعطاء كتلة لهذا التابع، فلن يُنشّط التعقب إلا في نطاق تلك الكتلة. البنية العامة enable→ true or false
enable { block } → obj
القيمة المعادة تعاد القيمة true إن كان التعقب مفعَّلًا أو تعاد القيمة false إذا كان معطَّلًا مسبقًا. أمثلة مثال على استعمال التابع enable: trace.enabled? #=> false
trace.enable #=> false (previous state)
# ...
التابع TracePoint.return_value في روبي
يُعيد التابع return_value قيمة الحدث :return و c_return و b_return. البنية العامة return_value()
القيمة المعادة تعاد قيمة الحدث :return و c_return و b_return. انظر أيضًا التابع raised_exception: يعيد قيمة الاستثناء الذي تم إطلاقه في الحدث :raise. التابع self: يُعيد كائن التعقب (trace object) خلال الحدث. مصادر قسم التابع return_value في الصنف TracePoint في توثيق روبي الرسمي.
التابع TracePoint.path في روبي
يعيد التابع path مسار الملف الجاري تنفيذه. البنية العامة path()
القيمة المعادة يعاد مسار الملف الجاري تنفيذه. انظر أيضًا التابع method_id: يعيد الاسم المعطى ساعة تعريف التابع المُستدعى. مصادر قسم التابع path في الصنف TracePoint في توثيق روبي الرسمي.
التابع TracePoint.binding في روبي
يُعيد التابع binding كائن الربط (binding object) الذي تم إنشاؤه من الحدث. البنية العامة binding()
القيمة المعادة يعاد كائن الربط (binding object) الذي تم إنشاؤه من الحدث. انظر أيضًا التابع callee_id: يُعيد اسم الاستدعاء الخاص بالتابع الذي يتم استدعاؤه مصادر قسم التابع binding في الصنف TracePoint في توثيق روبي الرسمي.
التابع TracePoint.lineno في روبي
يعيد التابع lineno رقم سطر الحدث التي يجري تعقبه. البنية العامة lineno()
القيمة المعادة يعاد رقم سطر الحدث التي يجري تعقبه. انظر أيضًا التابع inspect: يُعيد سلسلة نصية تحتوي حالة المتعقب وفق صيغة قابلة للقراءة. التابع method_id: يعيد الاسم المعطى ساعة تعريف التابع المُستدعى. مصادر قسم التابع lineno في الصنف TracePoint في توثيق روبي الرسمي.
التابع TracePoint.disable في روبي
يعطل التابع disable التعقب. في حال إعطاء كتلة لهذا التابع، فلن يُعطّل التعقب إلا ضمن نطاق تلك الكتلة. البنية العامة disable → true or false
disable { block } → obj
القيمة المعادة تعاد القيمة true إن كان التعقب مفعَّلًا أو تعاد القيمة false إذا كان معطَّلًا مسبقًا. أمثلة مثال على استعمال التابع disable: trace.enabled? #=> true
trace.disable #=> true (previous status)
trace.enabled? #=> false
trace.disable ...