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