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

من موسوعة حسوب
< Ruby‏ | Array

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

مصادر