Ruby/Array/push

يضيف التابع push جميع الكائنات المُمرّرة إليه إلى نهاية المصفوفة التي استُدعيت معه. يعيد هذا التابع المصفوفة نفسها، لذلك يمكن تطبيقه بشكل متسلسل.

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

 push(obj, ... ) → ary

المعاملات

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

القيم المعادة

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

أمثلة

أمثلة على استخدام التابع push:

 a = [ "a", "b", "c" ]
a.push("d", "e", "f")
       #=> ["a", "b", "c", "d", "e", "f"]
[1, 2, 3].push(4).push(5)
       #=> [1, 2, 3, 4, 5]

انظر أيضًا

• التابع insert: يُدرج القيم المُمرّرة إليه قبل عنصرٍ ذي فهرس محدد.
• التابع unshift: يضيف الكائنات المُمرَّرة إليه إلى بداية المصفوفة التي استُدعيت معه مع إزاحة العناصر الأخرى إلى الأمام.
• التابع pop: يحذف آخر عنصر أو آخر n عنصر من مصفوفة ثم يعيده أو يعيدها في مصفوفة جديدة.

مصادر

• قسم التابع push في الصنف Array في توثيق روبي الرسمي.