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

يعيد التابع first أول عنصر أو أول n عنصر من عناصر الكائن القابل للتعداد الذي استدعي معه.

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

first → obj or nil
first(n) → an_array

المعاملات

n

عدد صحيح يحدِّد عدد العناصر الأولى المراد جلبها من الكائن القابل للتعداد المعطى.

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

يعاد أول عنصر من عناصر الكائن القابل للتعداد المعطى، أو تعاد مصفوفة تحوي أول n - إن أعطي - عنصر من ذلك الكائن، أو تعاد القيمة nil إن كان ذلك الكائن فارغًا ولم يُعطَ المعامل n، أو تعاد مصفوفة فارغة إن كان الكائن فارغًا وحُدِّد المعامل n.

أمثلة

مثال على استعمال التابع first:

%w[foo bar baz].first     #=> "foo"
%w[foo bar baz].first(2)  #=> ["foo", "bar"]
%w[foo bar baz].first(10) #=> ["foo", "bar", "baz"]
[].first                  #=> nil
[].first(10)              #=> []

انظر أيضًا

• التابع detect: يمرِّر كل عنصر من عناصر المُعدِّد الذي استدعي معه إلى الكتلة المعطاة ثم يعيد أول عنصر لا تعيد الكتلة معه القيمة false.

• التابع drop: يحذف أول عدة عناصر من المُعدِّد الذي استدعي معه ثم يعيد بقية العناصر في مصفوفة.

مصادر

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