التابع Array.insert في روبي

يُدرج التابع insert القيم المُمرّرة إليه قبل عنصرٍ ذي فهرس محدد.

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

 insert(index, obj...) → ary

المعاملات

index

عدد صحيح يمثل فهرس العنصر المراد إدراج محتوى المعامل ...obj قبله.

إن أعطيت قيمة سالبة للفهرس index، فسيُحسَب موقع العنصر بدءًا من نهاية المصفوفة وستضاف تلك القيم المعطاة بعد العنصر، إذ يمثِّل الفهرس ‎-‎1 مثلًا آخر عنصر في المصفوفة وستضاف القيم الممررة في نهاية المصفوفة.

...obj

الكائنات المراد إدراجها قبل العنصر ذي الفهرس index في المصفوفة المعطاة.

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

تعاد المصفوفة نفسها بعد إضافة العناصر ...obj قبل العنصر ذي الفهرس index إن كان موجبًا أو بعده إن كان سالبًا.

أمثلة

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

 a = %w{ a b c d }
a.insert(2, 99)         #=> ["a", "b", 99, "c", "d"]
a.insert(-2, 1, 2, 3)   #=> ["a", "b", 99, "c", 1, 2, 3, "d"]

انظر أيضًا

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

مصادر

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