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