التابع `Array.first` في روبي

يجلب التابع first أول عنصر أو أول n عنصر من مصفوفة.

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

 first → obj or nil
first(n) → new_ary

المعاملات

n عدد صحيح يحدد عدد العناصر الأولى المراد جلبها من المصفوفة المعطاة.

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

يعاد العنصر الأول من المصفوفة المعطاة إن لم يمرَّر أي وسيط، أو تعاد مصفوفة جديدة تحوي أول n عنصر من المصفوفة المعطاة. إن كانت المصفوفة فارغة، فستعاد القيمة nil إن لم يمرَّر أي وسيط، أو تعاد مصفوفة فارغة إن أعطي الوسيط n.

أمثلة

أمثلة على استخدام التابع first:

 a = [ "q", "r", "s", "t" ]
a.first     #=> "q"
a.first(2)  #=> ["q", "r"]

انظر أيضًا

التابع last: يعيد التابع last آخر عنصر من المصفوفة التي استُدعي عبرها، في حال كانت المصفوفة فارغة فسيعيد الشكل الأول (أنظر فقرة البينة العامة) القيمة nil.
التابع fetch: يجلب عنصرًا ذي فهرس محدَّد من مصفوفة.
التابع drop: يحذف أول n عنصر من مصفوفة ثمَّ يضع بقية العناصر في مصفوفة جديدة ويعيدها.

مصادر

قسم التابع first في الصنف Array في توثيق روبي الرسمي.