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

المراجعة الحالية بتاريخ 07:03، 2 أكتوبر 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: يستدعي الكتلة البرمجية المحددة على كل عنصر من عناصر المصفوفة، ويعيد مصفوفة جديدة تحتوي القيم المُعادة من قبل الكتلة.

مصادر

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

@@ سطر 3: / سطر 3: @@
 [[تصنيف: Ruby Method]]
 [[تصنيف: 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
@@ سطر 10: / سطر 9: @@
   </syntaxhighlight>
 ==المعاملات==
-<code>n</code>
+=== <code>n</code> ===
 عددٌ صحيحٌ يحدد عدد مرات تطبيق الكتلة <code>block</code> على كل عنصر من عناصر المصفوفة المعطاة. قيمته الافتراضية هي: <code>nil</code>؛ أي تكرار تطبيق الكتلة عددًا لا نهائيًّا من المرات.
 ==القيم المعادة==
@@ سطر 23: / سطر 23: @@
 * التابع [[Ruby/Array/collect | <code>collect</code>]]‎: يستدعي كتلة برمجية محدَّدة مع كل عنصر من عناصر مصفوفة ثمَّ يعيد مصفوفة جديدة تحوي القيم التي تعيدها تلك الكتلة.
 * التابع [[Ruby/Array/each | <code>each</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 في توثيق روبي الرسمي.]