الفرق بين المراجعتين لصفحة: «Ruby/Array/rotate!»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>Array.rotate!</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Ruby Method تصنيف: Ruby...' |
جميل-بيلوني (نقاش | مساهمات) ط مراجعة وتدقيق. |
||
| (مراجعتان متوسطتان بواسطة مستخدمين اثنين آخرين غير معروضتين) | |||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby Array]] | [[تصنيف: Ruby Array]] | ||
يُدوّر التابع <code>rotate!</code> | يُدوّر التابع <code>rotate!</code> عناصر المصفوفة التي استُدعيت معه ليكون العنصر ذو الفهرس الممرَّر إليها هو العنصر الأول. | ||
إن كان العدد الممرَّر إليها سالبًا، فسيُدوّر التابع | |||
إن كان العدد الممرَّر إليها سالبًا، فسيُدوّر التابع <code>rotate!</code> المصفوفة في الاتجاه المعاكس، إذ يُحسَب موضع العنصر بدءًا من نهاية المصفوفة فسيكون فهرس العنصر الأخير هو -1. | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby"> rotate!(count=1) → ary | <syntaxhighlight lang="ruby">rotate!(count=1) → ary | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==المعاملات== | ==المعاملات== | ||
=== <code>count</code> === | |||
عددٌ صحيحٌ يمثل فهرس العنصر الذي يراد أن يصبح أول عنصرٍ في المصفوفة المعطاة. | عددٌ صحيحٌ يمثل فهرس العنصر الذي يراد أن يصبح أول عنصرٍ في المصفوفة المعطاة. | ||
==القيم المعادة== | ==القيم المعادة== | ||
تعاد المصفوفة نفسها المعطاة بعد إزاحة (تدوير) عناصرها ليكون العنصر ذو الفهرس | تعاد المصفوفة نفسها المعطاة بعد إزاحة (تدوير) عناصرها ليكون العنصر ذو الفهرس <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"] | ||
a #=> ["b", "c", "d", "a"] | a #=> ["b", "c", "d", "a"] | ||
| سطر 22: | سطر 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>]]: يضيف جميع الكائنات المُمرّرة إليه إلى نهاية المصفوفة التي استُدعيت معه. | ||
==مصادر== | ==مصادر== | ||
* قسم التابع rotate! في الصنف Array في توثيق روبي الرسمي. | * [https://ruby-doc.org/core-2.5.1/Array.html#method-i-rotate-21 قسم التابع rotate! في الصنف Array في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 09:38، 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: يضيف جميع الكائنات المُمرّرة إليه إلى نهاية المصفوفة التي استُدعيت معه.