عرض مصدر Python/itertools/cycle

<noinclude>{{DISPLAYTITLE:الدالة <code>itertools.cycle()‎</code> في بايثون}}</noinclude>
تعيد الدّالة <code>itertools.cycle()‎</code> مُكرّرًا يُعيد عناصر الكائن القابل للتّكرار المُعطى ويحفظ نسخة منه، عندما تنتهي قيم الكائن القابل للتّكرار، يُعيد المُكرّر عناصر النّسخة المحفوظة، ويُكرّر ذلك مرارًا وتكرارًا دون نهاية،

== البنية العامة ==
<syntaxhighlight lang="python3">
itertools.cycle(iterable)
</syntaxhighlight>

== المعاملات ==
=== <code>iterable</code> ===
الكائن القابل للتّكرار المرغوب الدّوران على قيمه بشكل لا نهائيّ.

== القيمة المعادة ==
مُكرّر يُعيد قيم الكائن المُعطى مرارًا وتكرارًا.

== أمثلة ==
المثال التّالي يوضّح كيفيّة عمل هذه الدّالة، لاحظ استعمال الدّالة <code>[[Python/next|next‎()]]</code>‎ للوصول إلى القيمة المواليّة في المُكرّر، وهذا لأنّ المُكرّر النّاتج لا متناهٍ، وتحويله إلى قائمة بالدّالة <code>[[Python/list|list()]]</code>‎ سيملأ الذّاكرة العشوائيّة (RAM):
<syntaxhighlight lang="python3">
>>> import itertools
>>> c = itertools.cycle('ABC')
>>> next(c)
'A'
>>> next(c)
'B'
>>> next(c)
'C'
>>> next(c)
'A'
>>> next(c)
'B'
>>> next(c)
'C'
>>> next(c)
'A'
>>> next(c)
'B'
>>> next(c)
'C'
>>> next(c)
'A'
</syntaxhighlight>

== ملاحظات ==
الدّالة مُكافئة لما يلي:
<syntaxhighlight lang="python3">
def cycle(iterable):
    # cycle('ABCD') --> A B C D A B C D A B C D ...
    saved = []
    for element in iterable:
        yield element
        saved.append(element)
    while saved:
        for element in saved:
              yield element
</syntaxhighlight>

لاحظ أنّ الدّالة قد تحتاج إلى مساحة تخزين كبيرة (اعتمادًا على حجم الكائن القابل للتّكرار).
== انظر أيضًا ==
* [[Python/iterators|المكرِّرات Iterators في بايثون]].
* [[Python/generators|المولدات Generators في بايثون]].
* [[Python/zip|الدالة <code>zip()‎</code> في بايثون]].
* [[Python/list|الدالة <code>list()‎</code> في بايثون]].

== مصادر ==
* [https://docs.python.org/3/library/itertools.html#itertools.cycle قسم الدالة itertools.cycle في توثيق Python الرسمي].
[[تصنيف:Python]]
[[تصنيف:Python Function]]
[[تصنيف:Python Built-in Functions]]