التابع Enumerable.first في روبي
< Ruby | Enumerable
يعيد التابع 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.