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