الفرق بين المراجعتين لصفحة: «Ruby/Array/first»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>Array.first</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Ruby Method تصنيف: Ruby Array...' |
لا ملخص تعديل |
||
| سطر 9: | سطر 9: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==المعاملات== | ==المعاملات== | ||
<code>n</code> | |||
=== <code>n</code> === | |||
عدد صحيح يحدد عدد العناصر الأولى المراد جلبها من المصفوفة المعطاة. | عدد صحيح يحدد عدد العناصر الأولى المراد جلبها من المصفوفة المعطاة. | ||
==القيم المعادة== | ==القيم المعادة== | ||
يعاد العنصر الأول من المصفوفة المعطاة إن لم يمرَّر أي وسيط، أو تعاد مصفوفة جديدة تحوي أول <code>n</code> عنصر من المصفوفة المعطاة. | يعاد العنصر الأول من المصفوفة المعطاة إن لم يمرَّر أي وسيط، أو تعاد مصفوفة جديدة تحوي أول <code>n</code> عنصر من المصفوفة المعطاة. | ||
إن كانت المصفوفة فارغة، فستعاد القيمة <code>nil</code> إن لم يمرَّر أي وسيط، أو تعاد مصفوفة فارغة إن أعطي الوسيط <code>n</code>. | إن كانت المصفوفة فارغة، فستعاد القيمة <code>nil</code> إن لم يمرَّر أي وسيط، أو تعاد مصفوفة فارغة إن أعطي الوسيط <code>n</code>. | ||
==أمثلة== | ==أمثلة== | ||
| سطر 21: | سطر 23: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
* التابع <code>last</code>: يعيد التابع <code>last</code> آخر عنصر من المصفوفة التي استُدعي عبرها، في حال كانت المصفوفة فارغة فسيعيد الشكل الأول (أنظر فقرة البينة العامة) القيمة <code>nil</code>. | * التابع <code>[[Ruby/Array/last|last]]</code>: يعيد التابع <code>last</code> آخر عنصر من المصفوفة التي استُدعي عبرها، في حال كانت المصفوفة فارغة فسيعيد الشكل الأول (أنظر فقرة البينة العامة) القيمة <code>nil</code>. | ||
* التابع [[Ruby/Array/fetch | <code>fetch</code>]]: يجلب عنصرًا ذي فهرس محدَّد من مصفوفة. | * التابع [[Ruby/Array/fetch | <code>fetch</code>]]: يجلب عنصرًا ذي فهرس محدَّد من مصفوفة. | ||
* التابع [[Ruby/Array/drop | <code>drop</code>]]: يحذف أول <code>n</code> عنصر من مصفوفة ثمَّ يضع بقية العناصر في مصفوفة جديدة ويعيدها. | * التابع [[Ruby/Array/drop | <code>drop</code>]]: يحذف أول <code>n</code> عنصر من مصفوفة ثمَّ يضع بقية العناصر في مصفوفة جديدة ويعيدها. | ||
==مصادر== | ==مصادر== | ||
* قسم التابع first في الصنف Array في توثيق روبي الرسمي. | * [https://ruby-doc.org/core-2.5.1/Array.html#method-i-first قسم التابع first في الصنف Array في توثيق روبي الرسمي.] | ||
مراجعة 17:19، 6 سبتمبر 2018
يجلب التابع 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عنصر من مصفوفة ثمَّ يضع بقية العناصر في مصفوفة جديدة ويعيدها.