Python/itertools/count

تعيد الدّالة itertools.count()‎ مُكرّرًا يُعيد قيمًا مُتساويّة الفرق بدءًا من قيمةٍ بدئيّة. عادة ما يُستخدم مع الدّالة map()‎ لتوليد نقاط بيانات تسلسليّة. وتُستخدم كذلك مع الدّالة zip()‎ لترقيم تسلسل معيّن.

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

itertools.count(start=0, step=1)

المعاملات

start

نقطة بداية العدّ.

step

الفرق بين كلّ قيمة والتي تليها.

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

مُكرّرٌ يُعيد قيمًا مُتساويّة الفرق حسب قيم المُعاملات المُمرّرة.

أمثلة

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

>>> c = itertools.count()
>>> next(c)
0
>>> next(c)
1
>>> next(c)
2
>>> next(c)
3
>>> next(c)
4

>>> c = itertools.count(10)
>>> next(c)
10
>>> next(c)
11
>>> next(c)
12

ملاحظات

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

def count(start=0, step=1):
    # count(10) --> 10 11 12 13 14 ...
    # count(2.5, 0.5) -> 2.5 3.0 3.5 ...
    n = start
    while True:
        yield n
        n += step

عند العدّ بالأعداد العشريّة، يُمكن الحصول أحيانًا على دقّة أفضل عبر استعمال شيفرة مُضاعِفة كما يلي:

(start + step * i for i in itertools.count())

وهذا مثال يشرح الفرق بين الطّريقتين:

>>> c = (2.5 + 0.1 * i for i in itertools.count())
>>> next(c)
2.5
>>> next(c)
2.6
>>> next(c)
2.7
>>> next(c)
2.8
>>> next(c)
2.9
>>> next(c)
3.0
>>> next(c)
3.1
>>> next(c)
3.2


>>> c = itertools.count(2.5, 0.1)
>>> next(c)
2.5
>>> next(c)
2.6
>>> next(c)
2.7
>>> next(c)
2.8000000000000003
>>> next(c)
2.9000000000000004
>>> next(c)
3.0000000000000004
>>> next(c)
3.1000000000000005

انظر أيضًا

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

مصادر

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