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

<noinclude>{{DISPLAYTITLE: التابع <code>Array.take</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Array]]
يجلب التابع <code>take</code> أول <code>n</code> عنصر من مصفوفة.

إن مرِّر عدد سالب إلى هذا التابع، فسيُطلَق الخطأ <code>ArgumentError</code>.
==البنية العامة==
<syntaxhighlight lang="ruby">take(n) → new_ary
 </syntaxhighlight>
==المعاملات==

=== <code>n</code> ===
عدد صحيح يمثل عدد العناصر الأولى المراد جلبها من المصفوفة المعطاة.
==القيم المعادة==
تعاد مصفوفة جديدة تحوي العناصر <code>n</code> الأولى الموجودة في المصفوفة المعطاة.
==أمثلة==
مثالٌ على استخدام التابع <code>take</code>:
<syntaxhighlight lang="ruby">a = [1, 2, 3, 4, 5, 0]
a.take(3)             #=> [1, 2, 3]
 </syntaxhighlight>
==انظر أيضًا==
* التابع<nowiki/>[[Ruby/Array/take_while | <code>take_while</code>]]: يجلب العناصر الأولى من مصفوفة التي تحقق شرطًا معينًا.
* التابع<nowiki/>[[Ruby/Array/drop | <code>drop</code>]]: يحذف أول <code>n</code> عنصر من المصفوفة ويعيد بقية العناصر في مصفوفة جديدة.
* التابع<nowiki/>[[Ruby/Array/delete_at | <code>delete_at</code>]]: يحذف العنصر من المصفوفة الموجود عند الفهرس المحدد
* التابع<nowiki/>[[Ruby/Array/reject! | <code>reject!‎</code>]]: يحذف كل عنصر من عناصر المصفوفة والتي تُقيّم في الكتلة البرمجية المحددة بالقيمة <code>true</code>.
==مصادر==
* [https://ruby-doc.org/core-2.5.1/Array.html#method-i-take قسم التابع take في الصنف Array في توثيق روبي الرسمي.]