الفرق بين المراجعتين لصفحة: «Ruby/Array/rotate»

مراجعة 16:44، 8 سبتمبر 2018

يعيد التابع 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 في توثيق روبي الرسمي.

@@ سطر 4: / سطر 4: @@
 [[تصنيف: Ruby Array]]
 يعيد التابع <code>rotate</code> مصفوفة جديدة تحتوي عناصر المصفوفة التي استُدعيت معها مع إزاحة (تدوير) عناصرها ليكون العنصر ذو الفهرس الممرر إليها هو العنصر الأول في المصفوفة الجديدة.
-إن كان العدد الممرر إليها سالبًا، فسيُدوّر التابع <code>rotate</code> المصفوفة في الاتجاه المعاكس، إذ يُحسَب موضع العنصر بدءًا من نهاية المصفوفة فسيكون فهرس العنصر الأخير هو ‎-1‎.
+إن كان العدد الممرر إليها سالبًا، فسيُدوّر التابع <code>rotate</code> المصفوفة في الاتجاه المعاكس، إذ يُحسَب موضع العنصر بدءًا من نهاية المصفوفة فسيكون فهرس العنصر الأخير هو ‎<code>-1</code>‎.
 ==البنية العامة==
 <syntaxhighlight lang="ruby"> rotate(count=1) → new_ary
   </syntaxhighlight>
 ==المعاملات==
-[[Ruby/Array/count | <code>count</code>]]
+=== <code>count</code> ===
 عددٌ صحيحٌ يمثل فهرس العنصر الذي يراد أن يصبح أول عنصرٍ في المصفوفة المعطاة.
-القيمة المعادة
-تعاد مصفوفة جديدة تحتوي عناصر المصفوفة التي استُدعيت معها مع إزاحة (تدوير) عناصرها ليكون العنصر ذو الفهرس [[Ruby/Array/count | <code>count</code>]] هو العنصر الأول في المصفوفة الجديدة.
+=== القيمة المعادة ===
+تعاد مصفوفة جديدة تحتوي عناصر المصفوفة التي استُدعيت معها مع إزاحة (تدوير) عناصرها ليكون العنصر ذو الفهرس  <code>count</code> هو العنصر الأول في المصفوفة الجديدة.
 ==أمثلة==
 أمثلة على استخدام التابع <code>rotate</code>:
@@ سطر 22: / سطر 25: @@
   </syntaxhighlight>
 ==انظر أيضًا==
-* التابع [[Ruby/Array/rotate! | <code>rotate!</code>]]!‎: يُدوّر عناصر المصفوفة التي استُدعيت معه ليكون العنصر ذو الفهرس الممرَّر إليها هو العنصر الأول.
+* التابع [[Ruby/Array/rotate! | <code>rotate!‎</code>]]: يُدوّر عناصر المصفوفة التي استُدعيت معه ليكون العنصر ذو الفهرس الممرَّر إليها هو العنصر الأول.
 * التابع [[Ruby/Array/reverse | <code>reverse</code>]]‎: يعكس ترتيب عناصر المصفوفة التي استُدعيت معه ويضعها في مصفوفة جديدة.
 * التابع [[Ruby/Array/sort | <code>sort</code>]]: يرتب عناصر المصفوفة التي استُدعيت معه ويعيدها في مصفوفة جديدة.
-* التابع [[Ruby/Array/sort_by! | <code>sort_by!</code>]]!‎: يُرتب المصفوفة التي استُدعيت معه وفقًا لمجموعة من المفاتيح (<code>set</code> <code>of</code> <code>keys</code>) المولدة عبر تمرير كل عنصر من عناصر المصفوفة إلى كتلة برمجية مُحددة.
+* التابع [[Ruby/Array/sort_by! | <code>sort_by!‎</code>]]: يُرتب المصفوفة التي استُدعيت معه وفقًا لمجموعة من المفاتيح (<code>set</code> <code>of</code> <code>keys</code>) المولدة عبر تمرير كل عنصر من عناصر المصفوفة إلى كتلة برمجية مُحددة.
 * التابع [[Ruby/Array/shift | <code>shift</code>]]: يحذف أول عنصر أو أول <code>n</code> عنصر من عناصر مصفوفة ثم يعيده أو يعيد مصفوفة تحوي العناصر المحذوفة.
 ==مصادر==
-* قسم التابع rotate في الصنف Array في توثيق روبي الرسمي.
+* [https://ruby-doc.org/core-2.5.1/Array.html#method-i-rotate قسم التابع rotate في الصنف Array في توثيق روبي الرسمي.]