الفرق بين المراجعتين لصفحة: «Ruby/Array/unshift»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط مراجعة وتدقيق. |
||
| سطر 5: | سطر 5: | ||
يضيف التابع <code>unshift</code> الكائنات المُمرَّرة إليه إلى بداية المصفوفة التي استُدعيت معه مع إزاحة العناصر الأخرى إلى الأمام. | يضيف التابع <code>unshift</code> الكائنات المُمرَّرة إليه إلى بداية المصفوفة التي استُدعيت معه مع إزاحة العناصر الأخرى إلى الأمام. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby"> unshift(obj, ...) → ary | <syntaxhighlight lang="ruby">unshift(obj, ...) → ary | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==المعاملات== | ==المعاملات== | ||
| سطر 12: | سطر 12: | ||
الكائن المراد إضافته في بداية المصفوفة المعطاة. | الكائن المراد إضافته في بداية المصفوفة المعطاة. | ||
=== … === | === <code>…</code> === | ||
الكائنات الأخرى المراد إضافتها في بداية المصفوفة المعطاة. | الكائنات الأخرى المراد إضافتها في بداية المصفوفة المعطاة. | ||
==القيم المعادة== | ==القيم المعادة== | ||
| سطر 18: | سطر 18: | ||
==أمثلة== | ==أمثلة== | ||
بعض أمثلة على استخدام التابع <code>unshift</code>: | بعض أمثلة على استخدام التابع <code>unshift</code>: | ||
<syntaxhighlight lang="ruby"> a = [ "b", "c", "d" ] | <syntaxhighlight lang="ruby">a = [ "b", "c", "d" ] | ||
a.unshift("a") #=> ["a", "b", "c", "d"] | a.unshift("a") #=> ["a", "b", "c", "d"] | ||
a.unshift(1, 2) #=> [ 1, 2, "a", "b", "c", "d"] | a.unshift(1, 2) #=> [ 1, 2, "a", "b", "c", "d"] | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
* التابع [[Ruby/Array/push | <code>push</code>]]: يضيف جميع الكائنات المُمرّرة إليه إلى نهاية المصفوفة التي استُدعيت معه. | * التابع<nowiki/>[[Ruby/Array/push | <code>push</code>]]: يضيف جميع الكائنات المُمرّرة إليه إلى نهاية المصفوفة التي استُدعيت معه. | ||
* التابع [[Ruby/Array/shift | <code>shift</code>]]: يحذف أول عنصر أو أول <code>n</code> عنصر من عناصر مصفوفة ثم يعيده أو يعيد مصفوفة تحوي العناصر المحذوفة. | * التابع<nowiki/>[[Ruby/Array/shift | <code>shift</code>]]: يحذف أول عنصر أو أول <code>n</code> عنصر من عناصر مصفوفة ثم يعيده أو يعيد مصفوفة تحوي العناصر المحذوفة. | ||
* التابع [[Ruby/Array/pop | <code>pop</code>]]: يحذف آخر عنصر أو آخر <code>n</code> عنصر من مصفوفة ثم يعيده أو يعيدها في مصفوفة جديدة. | * التابع<nowiki/>[[Ruby/Array/pop | <code>pop</code>]]: يحذف آخر عنصر أو آخر <code>n</code> عنصر من مصفوفة ثم يعيده أو يعيدها في مصفوفة جديدة. | ||
* التابع [[Ruby/Array/drop | <code>drop</code>]]: يحذف أول <code>n</code> عنصر من مصفوفة ثمَّ يضع بقية العناصر في مصفوفة جديدة ويعيدها. | * التابع<nowiki/>[[Ruby/Array/drop | <code>drop</code>]]: يحذف أول <code>n</code> عنصر من مصفوفة ثمَّ يضع بقية العناصر في مصفوفة جديدة ويعيدها. | ||
==مصادر== | ==مصادر== | ||
* [https://ruby-doc.org/core-2.5.1/Array.html#method-i-unshift قسم التابع unshift في الصنف Array في توثيق روبي الرسمي.] | * [https://ruby-doc.org/core-2.5.1/Array.html#method-i-unshift قسم التابع unshift في الصنف Array في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 10:28، 3 أكتوبر 2018
يضيف التابع unshift الكائنات المُمرَّرة إليه إلى بداية المصفوفة التي استُدعيت معه مع إزاحة العناصر الأخرى إلى الأمام.
البنية العامة
unshift(obj, ...) → ary
المعاملات
obj
الكائن المراد إضافته في بداية المصفوفة المعطاة.
…
الكائنات الأخرى المراد إضافتها في بداية المصفوفة المعطاة.
القيم المعادة
تعاد المصفوفة نفسها المعطاة بعد إضافة الكائن 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عنصر من مصفوفة ثمَّ يضع بقية العناصر في مصفوفة جديدة ويعيدها.