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

المراجعة الحالية بتاريخ 06:48، 17 نوفمبر 2018

يضبط (Controls) التابع trace_var تعقّبات (tracing) تعيين المتغيرات العامة.

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

trace_var(symbol, cmd ) → nil
trace_var(symbol) {|val| block } → nil‎

يحدد الوسيط المعطى symbol المتغير (إمَّا على شكل سلسلة نصية أو معرف رمز [symbol identifier]). يتم تنفيذ الأمر cmd (الذي قد يكون سلسلةً نصيةً أو كائن من النوع Proc أو كتلةً برمجيةً) كلما تم تعيين المتغير ثم تتلقى الكتلة أو الكائن Proc القيمة الجديدة للمتغير كوسيط.

المعاملات

`symbol‎`

يحدد المتغير.

`cmd‎`

التعليمة المراد تنفيذها كلما تم تعيين المتغير.

القيمة المعادة

تعاد القيمة nil.

أمثلة

مثال على استخدام التابع trace_var‎:

trace_var :$_, proc {|v| puts "$_ is now '#{v}'" }
$_ = "hello"
$_ = ' there'‎

ناتج تنفيذ هذا المثال هو:

$_ is now 'hello'
$_ is now ' there'‎

انظر أيضا

التابع untrace_var: يزيل التعقب (tracing) للتعليمة cmd المعطاة على المتغير الكلي المحدد، ثم يعيد nil.

مصادر

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

@@ سطر 3: / سطر 3: @@
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby Kernel]]
-يضبط التابع trace_var تعقّبات تعيين المتغيرات الكلية. يحدد الوسيط <code>symbol</code> المتغير (إما على شكل سلسلة نصية أو معرف رمز [symbol identifier]). يتم تنفيذ الوسيط cmd (الذي قد يكون سلسلة نصية أو كائن <code>Proc</code>) أو كتلة برمجية كلما تم تعيين المتغير. تتلقى الكتلة أو الكائن <code>Proc</code> القيمة الجديدة للمتغير كوسيط. انظر أيضا <code>Kernel::untrace_var</code>.
+يضبط (Controls) التابع <code>trace_var</code> تعقّبات (tracing) تعيين المتغيرات العامة.
-الناتج:
-<syntaxhighlight lang="ruby">$_ is now 'hello'
-$_ is now ' there'‎</syntaxhighlight>
 ==البنية العامة==
 <syntaxhighlight lang="ruby">trace_var(symbol, cmd ) → nil
-trace_var(symbol) {|val| block } → nil‎</syntaxhighlight>
+trace_var(symbol) {|val| block } → nil‎</syntaxhighlight>يحدد الوسيط المعطى <code>symbol</code> المتغير (إمَّا على شكل سلسلة نصية أو معرف رمز [symbol identifier]). يتم تنفيذ الأمر <code>cmd</code> (الذي قد يكون سلسلةً نصيةً أو كائن من النوع <code>Proc</code> أو كتلةً برمجيةً) كلما تم تعيين المتغير ثم تتلقى الكتلة أو الكائن <code>Proc</code> القيمة الجديدة للمتغير كوسيط.
 ==المعاملات==
 ===<code>symbol‎</code>===
+يحدد المتغير.
 ===<code>cmd‎</code>===
+التعليمة المراد تنفيذها  كلما تم تعيين المتغير.
-==القيمة المُعادة==
+==القيمة المعادة==
+تعاد القيمة <code>nil</code>.
 ==أمثلة==
@@ سطر 23: / سطر 22: @@
 <syntaxhighlight lang="ruby">trace_var :$_, proc {|v| puts "$_ is now '#{v}'" }
 $_ = "hello"
-$_ = ' there'‎</syntaxhighlight>
+$_ = ' there'‎</syntaxhighlight>ناتج تنفيذ هذا المثال هو:<syntaxhighlight lang="text">$_ is now 'hello'
+$_ is now ' there'‎</syntaxhighlight>
 ==انظر أيضا==
-* التابع <code>[[Ruby/Kernel/throw|throw]]</code>: ينقل التابع throw الضبط (control) إلى نهاية كتلة <code>catch</code> النشطة في انتظار الوسم (tag). ويطلق <code>UncaughtThrowError</code> إذا لم يكن هناك كتلة <code>catch</code> لذلك الوسم. يوفر الوسيط الاختياري الثاني قيمة لتُعيدها الكتلة <code>catch</code>، في حال عدم تمريره ستكون قيمتها الافتراضية هي <code>nil</code>. للحصول على بعض الأمثلة، انظر <code>Kernel::catch</code>.
+* التابع <code>[[Ruby/Kernel/untrace var|untrace_var]]</code>: يزيل التعقب (tracing) للتعليمة <code>cmd</code> المعطاة على المتغير الكلي المحدد، ثم يعيد <code>nil</code>.
-* التابع <code>[[Ruby/Kernel/trap|trap]]</code>: يحدد التابع trap معالج الإشارات (handling of signals). الوسيط الأول يمثل اسم إشارة (سلسلة نصية مثل "SIGALRM" أو "SIGUSR1" وغير ذلك) أو رقم إشارة. يمكن حذف الأحرف "SIG" من اسم الإشارة. تحدد التعليمة المعطاة cmd أو الكتلة الكود البرمجي المراد تشغيله عند إطلاق الإشارة. إذا كانت التعليمة هي السلسلة النصية "IGNORE" أو "SIG_IGN" ، فسيتم تجاهل الإشارة. أما إذا كانت تساوي "DEFAULT" أو "SIG_DFL" ، فسيُستدعى معالج روبي الافتراضي. لكن إذا كانت تساوي "EXIT" ، فستنهي الإشارة البرنامج النصي. إذا كان التعليمة تساوي "SYSTEM_DEFAULT" ، فسيتم استدعاء معالج نظام التشغيل الافتراضي. خلا ذلك، سيتم تشغيل التعليمة أو الكتلة المعطاة. سيتم استدعاء اسم الإشارة الخاص "EXIT"، أو رقم الإشارة 0، قبل إنهاء البرنامج مباشرة. يعيد التابع trap المعالج السابق للإشارة المعينة.
 ==مصادر==
-*[http://ruby-doc.org/core-2.5.1/Kernel.html#method-i-trace_var قسم  التابع trace_var‎ في الصنف Kernel‎ في توثيق روبي الرسمي.]
+*[http://ruby-doc.org/core-2.5.1/Kernel.html#method-i-trace_var قسم التابع trace_var‎ في الصنف Kernel‎ في توثيق روبي الرسمي.]