التابع 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
عنصر من مصفوفة ثمَّ يضع بقية العناصر في مصفوفة جديدة ويعيدها.