الفرق بين المراجعتين لصفحة: «Ruby/Array/insert»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| سطر 10: | سطر 10: | ||
=== <code>index</code> === | === <code>index</code> === | ||
عدد صحيح يمثل فهرس العنصر المراد إدراج محتوى المعامل ... | عدد صحيح يمثل فهرس العنصر المراد إدراج محتوى المعامل <code>...obj</code> قبله. | ||
=== ... | إن أعطيت قيمة سالبة للفهرس <code>index</code>، فسيُحسَب موقع العنصر بدءًا من نهاية المصفوفة وستضاف تلك القيم المعطاة بعد العنصر، إذ يمثِّل الفهرس <code>-1</code> مثلًا آخر عنصر في المصفوفة وستضاف القيم الممررة في نهاية المصفوفة. | ||
الكائنات المراد إدراجها قبل العنصر ذي الفهرس | |||
=== <code>...obj</code> === | |||
الكائنات المراد إدراجها قبل العنصر ذي الفهرس <code>index</code> في المصفوفة المعطاة. | |||
==القيم المعادة== | ==القيم المعادة== | ||
تعاد المصفوفة نفسها بعد إضافة العناصر ... | تعاد المصفوفة نفسها بعد إضافة العناصر <code>...obj</code> قبل العنصر ذي الفهرس <code>index</code> إن كان موجبًا أو بعده إن كان سالبًا. | ||
==أمثلة== | ==أمثلة== | ||
أمثلة على استخدام التابع <code>insert</code>: | أمثلة على استخدام التابع <code>insert</code>: | ||
| سطر 24: | سطر 25: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
* التابع [[Ruby/Array/push | <code>push</code>]]: يضيف جميع الكائنات المُمرّرة إليه إلى نهاية المصفوفة التي استُدعيت معه. | * التابع<nowiki/>[[Ruby/Array/push | <code>push</code>]]: يضيف جميع الكائنات المُمرّرة إليه إلى نهاية المصفوفة التي استُدعيت معه. | ||
* التابع [[Ruby/Array/fetch | <code>fetch</code>]]: يجلب عنصرًا ذي فهرس محدَّد من مصفوفة. | * التابع<nowiki/>[[Ruby/Array/fetch | <code>fetch</code>]]: يجلب عنصرًا ذي فهرس محدَّد من مصفوفة. | ||
* التابع [[Ruby/Array/unshift | <code>unshift</code>]]: يضيف الكائنات المُمرَّرة إليه إلى بداية المصفوفة التي استُدعيت معه مع إزاحة العناصر الأخرى إلى الأمام. | * التابع<nowiki/>[[Ruby/Array/unshift | <code>unshift</code>]]: يضيف الكائنات المُمرَّرة إليه إلى بداية المصفوفة التي استُدعيت معه مع إزاحة العناصر الأخرى إلى الأمام. | ||
==مصادر== | ==مصادر== | ||
* [https://ruby-doc.org/core-2.5.1/Array.html#method-i-insert قسم التابع insert في الصنف Array في توثيق روبي الرسمي.] | * [https://ruby-doc.org/core-2.5.1/Array.html#method-i-insert قسم التابع insert في الصنف Array في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 07:40، 3 أكتوبر 2018
يُدرج التابع 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: يضيف الكائنات المُمرَّرة إليه إلى بداية المصفوفة التي استُدعيت معه مع إزاحة العناصر الأخرى إلى الأمام.