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

يعيد التابع rotate مصفوفة جديدة تحتوي عناصر المصفوفة التي استُدعيت معها مع إزاحة (تدوير) عناصرها ليكون العنصر ذو الفهرس الممرر إليها هو العنصر الأول في المصفوفة الجديدة. إن كان العدد الممرر إليها سالبًا، فسيُدوّر التابع rotate المصفوفة في الاتجاه المعاكس، إذ يُحسَب موضع العنصر بدءًا من نهاية المصفوفة فسيكون فهرس العنصر الأخير هو ‎-1‎.

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

 rotate(count=1) → new_ary

المعاملات

count عددٌ صحيحٌ يمثل فهرس العنصر الذي يراد أن يصبح أول عنصرٍ في المصفوفة المعطاة. القيمة المعادة تعاد مصفوفة جديدة تحتوي عناصر المصفوفة التي استُدعيت معها مع إزاحة (تدوير) عناصرها ليكون العنصر ذو الفهرس count هو العنصر الأول في المصفوفة الجديدة.

أمثلة

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

 a = [ "a", "b", "c", "d" ]
a.rotate         #=> ["b", "c", "d", "a"]
a                #=> ["a", "b", "c", "d"]
a.rotate(2)      #=> ["c", "d", "a", "b"]
a.rotate(-3)     #=> ["b", "c", "d", "a"]

انظر أيضًا

• التابع rotate!!‎: يُدوّر عناصر المصفوفة التي استُدعيت معه ليكون العنصر ذو الفهرس الممرَّر إليها هو العنصر الأول.
• التابع reverse‎: يعكس ترتيب عناصر المصفوفة التي استُدعيت معه ويضعها في مصفوفة جديدة.
• التابع sort: يرتب عناصر المصفوفة التي استُدعيت معه ويعيدها في مصفوفة جديدة.
• التابع sort_by!!‎: يُرتب المصفوفة التي استُدعيت معه وفقًا لمجموعة من المفاتيح (set of keys) المولدة عبر تمرير كل عنصر من عناصر المصفوفة إلى كتلة برمجية مُحددة.
• التابع shift: يحذف أول عنصر أو أول n عنصر من عناصر مصفوفة ثم يعيده أو يعيد مصفوفة تحوي العناصر المحذوفة.

مصادر

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