الفرق بين المراجعتين لصفحة: «Python/itertools/repeat»

مراجعة 20:55، 17 يونيو 2018

تعيد الدّالة 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 الرسمي.

@@ سطر 2: / سطر 2: @@
 تعيد الدّالة <code>itertools.repeat()‎</code> مُكرّرًا يُعيد كائنًا مرارًا وتكرارًا بشكل لا نهائي أو لعدد مُحدّد من المرّات.
-تُستخدم مع  [[Python/map|الدالة <code>map()‎</code>]] لاستدعاء دالّة عدّة مرّات بنفس المُعاملات. وتُستخدم كذلك مع [[Python/zip|الدالة <code>zip()‎</code>]]لإنشاء جزء لا يتغيّر في كلّ صفّ.
+تُستخدم مع  [[Python/map|الدالة <code>map()‎</code>]] لاستدعاء دالّة عدّة مرّات بنفس المُعاملات. وتُستخدم كذلك مع الدالة <code>[[Python/zip|zip()‎]]</code> لإنشاء جزء لا يتغيّر في كلّ [[Python/tuples|صفّ]].
 == البنية العامة ==
@@ سطر 14: / سطر 14: @@
 === <code>times</code> ===
-عدد مرّات التّكرار.
+مُعامل اختياريّ يُحدّد عدد مرّات التّكرار، يكون التّكرار لا نهائيًّا إن لم تُمرّر له أيّة قيمة.
 == القيمة المعادة ==
-مُكرّر يُعيد الكائن بشكل لا نهائيّ أو لعدد مُحدّد من المرّات حسب ما مُرِّرَ للمُعامل  <code>times</code>.
+مُكرّر يُعيد الكائنَ بشكل لا نهائيّ أو لعدد مُحدّد من المرّات حسب ما مُرِّرَ للمُعامل  <code>times</code>.
 == أمثلة ==
-المثال التّالي يوضّح كيفيّة عمل هذه الدّالة، نستعمل في المثال الأول الدالة <code>next()‎</code> للوصول إلى القيمة التّالية من المُكرّر، وهذا لأنّ تحويل مُكرّر لا نهائي إلى قائمة سيملأ الذّاكرة العشوائيّة:
+المثال التّالي يوضّح كيفيّة عمل هذه الدّالة، نستعمل في المثال الأول الدالة <code>[[Python/next|next()‎]]</code> للوصول إلى القيمة التّالية من المُكرّر، وهذا لأنّ تحويل مُكرّر لا نهائي إلى [[Python/list|قائمة]] سيملأ الذّاكرة العشوائيّة:
 <syntaxhighlight lang="python3">
 >>> i = itertools.repeat('ABC')