التابع Array.unshift
في روبي
اذهب إلى التنقل
اذهب إلى البحث
يضيف التابع unshift
الكائنات المُمرَّرة إليه إلى بداية المصفوفة التي استُدعيت معه مع إزاحة العناصر الأخرى إلى الأمام.
البنية العامة
unshift(obj, ...) → ary
المعاملات
obj
الكائن المراد إضافته في بداية المصفوفة المعطاة.
…
الكائنات الأخرى المراد إضافتها في بداية المصفوفة المعطاة.
القيم المعادة
تعاد المصفوفة نفسها المعطاة بعد إضافة الكائن obj
والكائنات الأخرى الممررة إلى بدايتها.
أمثلة
بعض أمثلة على استخدام التابع unshift
:
a = [ "b", "c", "d" ]
a.unshift("a") #=> ["a", "b", "c", "d"]
a.unshift(1, 2) #=> [ 1, 2, "a", "b", "c", "d"]
انظر أيضًا
- التابع
push
: يضيف جميع الكائنات المُمرّرة إليه إلى نهاية المصفوفة التي استُدعيت معه. - التابع
shift
: يحذف أول عنصر أو أولn
عنصر من عناصر مصفوفة ثم يعيده أو يعيد مصفوفة تحوي العناصر المحذوفة. - التابع
pop
: يحذف آخر عنصر أو آخرn
عنصر من مصفوفة ثم يعيده أو يعيدها في مصفوفة جديدة. - التابع
drop
: يحذف أولn
عنصر من مصفوفة ثمَّ يضع بقية العناصر في مصفوفة جديدة ويعيدها.