الفرق بين المراجعتين لصفحة: «Ruby/Array/cycle»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>Array.cycle</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Ruby Method تصنيف: Ruby Array...' |
لا ملخص تعديل |
||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby Array]] | [[تصنيف: Ruby Array]] | ||
يستدعي التابع <code>cycle</code> كتلة برمجية محددة مع كل عنصر من عناصر المصفوفة عددًا محددًا من المرات أو عددًا لا نهائيًّا من المرات إن أعطيت القيمة <code>nil</code>. أمَّا إن مُرِّرت إليه قيمة سالبة أو كانت المصفوفة فارغة، فلن يفعل هذا التابع أي شيء. يعيد التابع القيمة <code>nil</code> إن انتهت سلسلة الاستدعاءات المطبقة على كل عنصر دون مقاطعة. | يستدعي التابع <code>cycle</code> كتلة برمجية محددة مع كل عنصر من عناصر المصفوفة عددًا محددًا من المرات أو عددًا لا نهائيًّا من المرات إن أعطيت القيمة <code>nil</code>. أمَّا إن مُرِّرت إليه قيمة سالبة أو كانت المصفوفة فارغة، فلن يفعل هذا التابع أي شيء. يعيد التابع القيمة <code>nil</code> إن انتهت سلسلة الاستدعاءات المطبقة على كل عنصر دون مقاطعة.إن لم تمرَّر أي كتلة، فسيعيد التابع <code>cycle</code> كائنا من النوع <code>Enumerator</code>. | ||
إن لم تمرَّر أي كتلة، فسيعيد التابع <code>cycle</code> كائنا من النوع <code>Enumerator</code>. | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby"> cycle(n=nil) { |obj| block } → nil | <syntaxhighlight lang="ruby"> cycle(n=nil) { |obj| block } → nil | ||
| سطر 10: | سطر 9: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==المعاملات== | ==المعاملات== | ||
<code>n</code> | |||
=== <code>n</code> === | |||
عددٌ صحيحٌ يحدد عدد مرات تطبيق الكتلة <code>block</code> على كل عنصر من عناصر المصفوفة المعطاة. قيمته الافتراضية هي: <code>nil</code>؛ أي تكرار تطبيق الكتلة عددًا لا نهائيًّا من المرات. | عددٌ صحيحٌ يحدد عدد مرات تطبيق الكتلة <code>block</code> على كل عنصر من عناصر المصفوفة المعطاة. قيمته الافتراضية هي: <code>nil</code>؛ أي تكرار تطبيق الكتلة عددًا لا نهائيًّا من المرات. | ||
==القيم المعادة== | ==القيم المعادة== | ||
| سطر 25: | سطر 25: | ||
* التابع [[Ruby/Array/map | <code>map</code>]]: يستدعي التابع [[Ruby/Array/map | <code>map</code>]] الكتلة البرمجية المحددة على كل عنصر من عناصر المصفوفة، ويعيد مصفوفة جديدة تحتوي القيم المُعادة من قبل الكتلة. | * التابع [[Ruby/Array/map | <code>map</code>]]: يستدعي التابع [[Ruby/Array/map | <code>map</code>]] الكتلة البرمجية المحددة على كل عنصر من عناصر المصفوفة، ويعيد مصفوفة جديدة تحتوي القيم المُعادة من قبل الكتلة. | ||
==مصادر== | ==مصادر== | ||
* قسم التابع cycle في الصنف Array في توثيق روبي الرسمي. | * [https://ruby-doc.org/core-2.5.1/Array.html#method-i-cycle قسم التابع cycle في الصنف Array في توثيق روبي الرسمي.] | ||
مراجعة 09:36، 6 سبتمبر 2018
يستدعي التابع cycle كتلة برمجية محددة مع كل عنصر من عناصر المصفوفة عددًا محددًا من المرات أو عددًا لا نهائيًّا من المرات إن أعطيت القيمة nil. أمَّا إن مُرِّرت إليه قيمة سالبة أو كانت المصفوفة فارغة، فلن يفعل هذا التابع أي شيء. يعيد التابع القيمة nil إن انتهت سلسلة الاستدعاءات المطبقة على كل عنصر دون مقاطعة.إن لم تمرَّر أي كتلة، فسيعيد التابع cycle كائنا من النوع Enumerator.
البنية العامة
cycle(n=nil) { |obj| block } → nil
cycle(n=nil) → Enumerator
المعاملات
n
عددٌ صحيحٌ يحدد عدد مرات تطبيق الكتلة block على كل عنصر من عناصر المصفوفة المعطاة. قيمته الافتراضية هي: nil؛ أي تكرار تطبيق الكتلة عددًا لا نهائيًّا من المرات.
القيم المعادة
تعاد القيمة nil عند انتهاء تطبيق الكتلة block على كل عنصر من عناصر المصفوفة المعطاة n مرة أو عددًا لا نهائيًّا من المرات إن كانت قيمة الوسيط n هي nil (القيمة الافتراضية)، أو يعاد كائن من النوع Enumerator إن لم تعطَ الكتلة block.
أمثلة
أمثلة على استخدام التابع cycle:
a = ["a", "b", "c"]
a.cycle { |x| puts x } # print, a, b, c, a, b, c,.. forever.
a.cycle(2) { |x| puts x } # print, a, b, c, a, b, c.
انظر أيضًا
- التابع
collect: يستدعي كتلة برمجية محدَّدة مع كل عنصر من عناصر مصفوفة ثمَّ يعيد مصفوفة جديدة تحوي القيم التي تعيدها تلك الكتلة. - التابع
each: يستدعي كتلة برمجية محدَّدة مع كل عنصر من عناصر مصفوفة، إذ تمرَّر قيمة ذلك العنصر كوسيط إلى الكتلة ثمَّ يعيد المصفوفة نفسها المعطاة. - التابع
map: يستدعي التابعmapالكتلة البرمجية المحددة على كل عنصر من عناصر المصفوفة، ويعيد مصفوفة جديدة تحتوي القيم المُعادة من قبل الكتلة.