عرض مصدر Ruby/Array/fetch

<noinclude>{{DISPLAYTITLE: التابع <code>Array.fetch</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Array]]
يجلب التابع <code>fetch</code> عنصرًا ذا فهرس محدَّد من مصفوفة. إن كان الفهرس المعطى لعنصرٍ يقع خارج نطاق المصفوفة، فسيُطلَق الخطأ <code>IndexError</code>. يمكن تجنب إطلاق هذا الخطأ بتمرير وسيطٍ ثانٍ أو كتلة برمجية إلى التابع <code>fetch</code> ليُظهَر أو تُنفَّذ في مثل هذه الحالة.
==البنية العامة==
<syntaxhighlight lang="ruby"> fetch(index) → obj
fetch(index, default) → obj
fetch(index) { |index| block } → obj
 </syntaxhighlight>
==المعاملات==

=== <code>index</code> ===
عدد صحيح يمثل فهرس العنصر المراد جلبه من المصفوفة المعطاة.

=== <code>default</code> ===
قيمة افتراضية تُطبَع -بدلًا من إطلاق الخطأ <code>IndexError</code>- عندما يشير الفهرس  <code>index</code> لعنصر يقع خارج نطاق المصفوفة.
==القيم المعادة==
يعاد العنصر ذو الفهرس  <code>index</code> من المصفوفة المعطاة. إن كانت قيمة الفهرس  <code>index</code> سالبة، فسيُحسَب موقع العنصر بدءًا من نهاية المصفوفة.

إن كان الفهرس  <code>index</code> يقع خارج مجال تلك المصفوفة المعطاة، فسيُرمى الخطأ <code>IndexError</code>، أو تُطبَع قيمة الوسيط <code>default</code> الافتراضية (إن أعطي)، أو تُنفَّذ الكتلة <code>block</code> (إن أعطيت).
==أمثلة==
بعض الأمثلة على استخدام التابع <code>fetch</code>:
<syntaxhighlight lang="ruby"> a = [ 11, 22, 33, 44 ]
a.fetch(1)               #=> 22
a.fetch(-1)              #=> 44
a.fetch(4, 'cat')        #=> "cat"
a.fetch(100) { |i| puts "#{i} is out of bounds" }
                        #=> "100 is out of bounds"
 </syntaxhighlight>
==انظر أيضًا==
* التابع [[Ruby/Array/at | <code>at</code>]]: يجلب عنصرًا ذي فهرس محدد من المصفوفة المستدعاة معه.
* التابع [[Ruby/Array/slice | <code>slice</code>]]: يجلب عنصرًا ذي فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من مصفوفة.
* التابع [[Ruby/Array/select | <code>select</code>]]: يحدد جميع عناصر المصفوفة المحققة لشرط معين ويضعها في مصفوفة جديدة.
* التابع [[Ruby/Array/drop_while | <code>drop_while</code>]]: يحذف عناصر المصفوفة الأولى التي تحقِّق شرطًا محدَّدًا ثمَّ يعيد مصفوفة جديدة تحوي بقية العناصر.
==مصادر==
* [https://ruby-doc.org/core-2.5.1/Array.html#method-i-fetch قسم التابع fetch في الصنف Array في توثيق روبي الرسمي.]