الفرق بين المراجعتين لصفحة: «Ruby/Kernel/caller locations»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط مراجعة وتدقيق |
||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby Kernel]] | [[تصنيف: Ruby Kernel]] | ||
يعيد التابع <code>caller_locations</code> مكدس التنفيذ (execution stack) | يعيد التابع <code>caller_locations</code> مكدس التنفيذ (execution stack) الحالي كمصفوفة تحتوي كائنات تعقب عكسي (backtrace location objects). | ||
انظر صفحة <code>[[Ruby/Thread | انظر صفحة <code>[[Ruby/Thread::Backtrace::Location|Thread::Backtrace::Location]]</code> لمزيد من المعلومات. | ||
==البنية العامة== | |||
يحدد الوسيط الاختياري <code>start</code> عدد مدخلات المكدس الأولية التي ستُحذف من أعلى المكدس. ويمكن استخدام | <syntaxhighlight lang="ruby">caller_locations(start=1, length=nil) → array or nil | ||
caller_locations(range)→ array or nil</syntaxhighlight>يحدد الوسيط الاختياري <code>start</code> عدد مدخلات المكدس الأولية التي ستُحذف من أعلى المكدس. ويمكن استخدام الوسيط <code>length</code> اختياري ثاني لتحديد عدد المدخلات التي ستُعاد من المكدس. | |||
يعيد التابع القيمة <code>nil</code> إن كان الوسيط <code>start</code> أكبر من حجم مكدس التنفيذ الحالي. | يعيد التابع القيمة <code>nil</code> إن كان الوسيط <code>start</code> أكبر من حجم مكدس التنفيذ الحالي. | ||
اختياريًا، يمكنك تمرير مجال <code>range</code>، والذي سيؤدي إلى إعادة مصفوفة تحتوي على المدخلات الموجودة ضمن المجال المحدد. | اختياريًا، يمكنك تمرير مجال <code>range</code>، والذي سيؤدي إلى إعادة مصفوفة تحتوي على المدخلات الموجودة ضمن المجال المحدد. | ||
==المعاملات== | ==المعاملات== | ||
===<code>start</code>=== | ===<code>start</code>=== | ||
يحدد هذا الوسيط الاختياري عدد مدخالات المكدس الأولية | يحدد هذا الوسيط الاختياري عدد مدخالات المكدس الأولية. | ||
===<code>length</code>=== | ===<code>length</code>=== | ||
| سطر 23: | سطر 21: | ||
===<code>range</code>=== | ===<code>range</code>=== | ||
في حال تمريره ستعاد مصفوفة تحتوي على المدخلات الموجودة ضمن المجال <code>range</code>. | في حال تمريره ستعاد مصفوفة تحتوي على المدخلات الموجودة ضمن المجال <code>[[Ruby/Range|range]]</code>. | ||
==القيمة | ==القيمة المعادة== | ||
تعاد مصفوفة تحتوي كائنات تعقب عكسي (backtrace location objects)، أو يعيد القيمة <code>nil</code> إن كان الوسيط <code>start</code> أكبر من حجم مكدس التنفيذ الحالي. | |||
==انظر أيضا== | ==انظر أيضا== | ||
* التابع <code>[[Ruby/ | * التابع <code>[[Ruby/Kernel/caller|caller]]</code>: يعيد مكدس التنفيذ الحالي (execution stack). | ||
==مصادر== | ==مصادر== | ||
*[http://ruby-doc.org/core-2.5.1/Kernel.html#method-i-caller_locations قسم | *[http://ruby-doc.org/core-2.5.1/Kernel.html#method-i-caller_locations قسم التابع caller_locations في الصنف Kernel في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 11:16، 15 نوفمبر 2018
يعيد التابع caller_locations مكدس التنفيذ (execution stack) الحالي كمصفوفة تحتوي كائنات تعقب عكسي (backtrace location objects).
انظر صفحة Thread::Backtrace::Location لمزيد من المعلومات.
البنية العامة
caller_locations(start=1, length=nil) → array or nil
caller_locations(range)→ array or nil
يحدد الوسيط الاختياري start عدد مدخلات المكدس الأولية التي ستُحذف من أعلى المكدس. ويمكن استخدام الوسيط length اختياري ثاني لتحديد عدد المدخلات التي ستُعاد من المكدس.
يعيد التابع القيمة nil إن كان الوسيط start أكبر من حجم مكدس التنفيذ الحالي.
اختياريًا، يمكنك تمرير مجال range، والذي سيؤدي إلى إعادة مصفوفة تحتوي على المدخلات الموجودة ضمن المجال المحدد.
المعاملات
start
يحدد هذا الوسيط الاختياري عدد مدخالات المكدس الأولية.
length
يحدد عدد المدخلات التي ستُعاد من المكدس.
range
في حال تمريره ستعاد مصفوفة تحتوي على المدخلات الموجودة ضمن المجال range.
القيمة المعادة
تعاد مصفوفة تحتوي كائنات تعقب عكسي (backtrace location objects)، أو يعيد القيمة nil إن كان الوسيط start أكبر من حجم مكدس التنفيذ الحالي.
انظر أيضا
- التابع
caller: يعيد مكدس التنفيذ الحالي (execution stack).