التابع `Array.unshift` في روبي

يضيف التابع unshift الكائنات المُمرَّرة إليه إلى بداية المصفوفة التي استُدعيت معه مع إزاحة العناصر الأخرى إلى الأمام.

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

unshift(obj, ...) → ary

الكائن المراد إضافته في بداية المصفوفة المعطاة.

الكائنات الأخرى المراد إضافتها في بداية المصفوفة المعطاة.

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