الفرق بين المراجعتين لصفحة: «Ruby/Array/unshift»

مراجعة 09:07، 9 سبتمبر 2018

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

@@ سطر 8: / سطر 8: @@
   </syntaxhighlight>
 ==المعاملات==
-<code>obj</code>
+=== <code>obj</code> ===
 الكائن المراد إضافته في بداية المصفوفة المعطاة.
-…
+=== … ===
 الكائنات الأخرى المراد إضافتها في بداية المصفوفة المعطاة.
 ==القيم المعادة==
@@ سطر 26: / سطر 28: @@
 * التابع [[Ruby/Array/drop | <code>drop</code>]]: يحذف أول <code>n</code> عنصر من مصفوفة ثمَّ يضع بقية العناصر في مصفوفة جديدة ويعيدها.
 ==مصادر==
-* قسم التابع unshift في الصنف Array في توثيق روبي الرسمي.
+* [https://ruby-doc.org/core-2.5.1/Array.html#method-i-unshift قسم التابع unshift في الصنف Array في توثيق روبي الرسمي.]