الفرق بين المراجعتين لصفحة: «Ruby/Array/rotate!»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| سطر 5: | سطر 5: | ||
يُدوّر التابع <code>rotate!</code> عناصر المصفوفة التي استُدعيت معه ليكون العنصر ذو الفهرس الممرَّر إليها هو العنصر الأول. | يُدوّر التابع <code>rotate!</code> عناصر المصفوفة التي استُدعيت معه ليكون العنصر ذو الفهرس الممرَّر إليها هو العنصر الأول. | ||
إن كان العدد الممرَّر إليها سالبًا، فسيُدوّر التابع | إن كان العدد الممرَّر إليها سالبًا، فسيُدوّر التابع <code>rotate!</code> المصفوفة في الاتجاه المعاكس، إذ يُحسَب موضع العنصر بدءًا من نهاية المصفوفة فسيكون فهرس العنصر الأخير هو -1. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby"> rotate!(count=1) → ary | <syntaxhighlight lang="ruby"> rotate!(count=1) → ary | ||
| سطر 14: | سطر 14: | ||
عددٌ صحيحٌ يمثل فهرس العنصر الذي يراد أن يصبح أول عنصرٍ في المصفوفة المعطاة. | عددٌ صحيحٌ يمثل فهرس العنصر الذي يراد أن يصبح أول عنصرٍ في المصفوفة المعطاة. | ||
==القيم المعادة== | ==القيم المعادة== | ||
تعاد المصفوفة نفسها المعطاة بعد إزاحة (تدوير) عناصرها ليكون العنصر ذو الفهرس | تعاد المصفوفة نفسها المعطاة بعد إزاحة (تدوير) عناصرها ليكون العنصر ذو الفهرس <code>count</code> هو العنصر الأول في المصفوفة. | ||
==أمثلة== | ==أمثلة== | ||
أمثلة على استخدام التابع | أمثلة على استخدام التابع <code>rotate!</code>: | ||
<syntaxhighlight lang="ruby"> a = [ "a", "b", "c", "d" ] | <syntaxhighlight lang="ruby"> a = [ "a", "b", "c", "d" ] | ||
a.rotate! #=> ["b", "c", "d", "a"] | a.rotate! #=> ["b", "c", "d", "a"] | ||
| سطر 24: | سطر 24: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
* التابع [[Ruby/Array/rotate | <code>rotate</code>]]: يعيد مصفوفة جديدة تحتوي عناصر المصفوفة التي استُدعيت معها مع إزاحة (تدوير) عناصرها ليكون العنصر ذو الفهرس الممرر إليها هو العنصر الأول في المصفوفة الجديدة. | * التابع<nowiki/>[[Ruby/Array/rotate | <code>rotate</code>]]: يعيد مصفوفة جديدة تحتوي عناصر المصفوفة التي استُدعيت معها مع إزاحة (تدوير) عناصرها ليكون العنصر ذو الفهرس الممرر إليها هو العنصر الأول في المصفوفة الجديدة. | ||
* التابع [[Ruby/Array/reverse! | <code>reverse!</code>]]: يعكس ترتيب عناصر المصفوفة التي استُدعيت معه. | * التابع<nowiki/>[[Ruby/Array/reverse! | <code>reverse!</code>]]: يعكس ترتيب عناصر المصفوفة التي استُدعيت معه. | ||
* التابع [[Ruby/Array/push | <code>push</code>]]: يضيف جميع الكائنات المُمرّرة إليه إلى نهاية المصفوفة التي استُدعيت معه. | * التابع<nowiki/>[[Ruby/Array/push | <code>push</code>]]: يضيف جميع الكائنات المُمرّرة إليه إلى نهاية المصفوفة التي استُدعيت معه. | ||
==مصادر== | ==مصادر== | ||
* [https://ruby-doc.org/core-2.5.1/Array.html#method-i-rotate-21 قسم التابع rotate! في الصنف Array في توثيق روبي الرسمي.] | * [https://ruby-doc.org/core-2.5.1/Array.html#method-i-rotate-21 قسم التابع rotate! في الصنف Array في توثيق روبي الرسمي.] | ||
مراجعة 09:29، 3 أكتوبر 2018
يُدوّر التابع rotate! عناصر المصفوفة التي استُدعيت معه ليكون العنصر ذو الفهرس الممرَّر إليها هو العنصر الأول.
إن كان العدد الممرَّر إليها سالبًا، فسيُدوّر التابع rotate! المصفوفة في الاتجاه المعاكس، إذ يُحسَب موضع العنصر بدءًا من نهاية المصفوفة فسيكون فهرس العنصر الأخير هو -1.
البنية العامة
rotate!(count=1) → ary
المعاملات
count
عددٌ صحيحٌ يمثل فهرس العنصر الذي يراد أن يصبح أول عنصرٍ في المصفوفة المعطاة.
القيم المعادة
تعاد المصفوفة نفسها المعطاة بعد إزاحة (تدوير) عناصرها ليكون العنصر ذو الفهرس count هو العنصر الأول في المصفوفة.
أمثلة
أمثلة على استخدام التابع rotate!:
a = [ "a", "b", "c", "d" ]
a.rotate! #=> ["b", "c", "d", "a"]
a #=> ["b", "c", "d", "a"]
a.rotate!(2) #=> ["d", "a", "b", "c"]
a.rotate!(-3) #=> ["a", "b", "c", "d"]
انظر أيضًا
- التابع
rotate: يعيد مصفوفة جديدة تحتوي عناصر المصفوفة التي استُدعيت معها مع إزاحة (تدوير) عناصرها ليكون العنصر ذو الفهرس الممرر إليها هو العنصر الأول في المصفوفة الجديدة. - التابع
reverse!: يعكس ترتيب عناصر المصفوفة التي استُدعيت معه. - التابع
push: يضيف جميع الكائنات المُمرّرة إليه إلى نهاية المصفوفة التي استُدعيت معه.