الدالة itertools.repeat()‎ في بايثون

تعيد الدّالة itertools.repeat()‎ مُكرّرًا يُعيد كائنًا مرارًا وتكرارًا بشكل لا نهائي أو لعدد مُحدّد من المرّات.

تُستخدم مع الدالة map()‎ لاستدعاء دالّة عدّة مرّات بنفس المُعاملات. وتُستخدم كذلك مع الدالة zip()‎ لإنشاء جزء لا يتغيّر في كلّ صفّ.

البنية العامة

itertools.repeat(object[, times])

المعاملات

object

الكائن المُراد تكراره.

times

مُعامل اختياريّ يُحدّد عدد مرّات التّكرار، يكون التّكرار لا نهائيًّا إن لم تُمرّر له أيّة قيمة.

القيمة المعادة

مُكرّر يُعيد الكائنَ بشكل لا نهائيّ أو لعدد مُحدّد من المرّات حسب ما مُرِّرَ للمُعامل times.

أمثلة

المثال التّالي يوضّح كيفيّة عمل هذه الدّالة، نستعمل في المثال الأول الدالة next()‎ للوصول إلى القيمة التّالية من المُكرّر، وهذا لأنّ تحويل مُكرّر لا نهائي إلى قائمة سيملأ الذّاكرة العشوائيّة:

>>> i = itertools.repeat('ABC')
>>> next(i)
'ABC'
>>> next(i)
'ABC'
>>> next(i)
'ABC'

>>> i = itertools.repeat('ABC', 4)
>>> list(i)
['ABC', 'ABC', 'ABC', 'ABC']

وتمرير تيار من القيم الثّابتة إلى الدالة map()‎ أو الدالة zip()‎ من الاستعمالات الشّائعة للدّالة itertools.repeat()‎:

>>> list(map(pow, range(10), repeat(2)))
[0, 1, 4, 9, 16, 25, 36, 49, 64, 81]

ملاحظات

الدّالة مُكافئة لما يلي:

def repeat(object, times=None):
    # repeat(10, 3) --> 10 10 10
    if times is None:
        while True:
            yield object
    else:
        for i in range(times):
            yield object

انظر أيضًا

• المكرِّرات Iterators في بايثون.
• المولدات Generators في بايثون.
• الدالة map()‎ في بايثون: تُطبّق دالة على كلّ عنصر من عناصر الكائن القابل للتّكرار.
• الدالة zip()‎ في بايثون: تُركّب عناصر الكائنات القابلة للتّكرار المُعطاة.
• الدالة list()‎ في بايثون: تُحوّل كائنًا قابلًا للتّكرار إلى قائمة.
• الدالة next()‎ في بايثون: تُعيد العنصر التّالي من المُكرّر.

مصادر

• قسم الدالة itertools.repeat في توثيق Python الرسمي.