الدالة enumerate()‎ في بايثون

تعيد الدّالة enumerate()‎ كائنًا قابلًا للتّكرار من النّوع enumerate. وتُستخدم لترقيم الكائنات القابلة للتّكرار.

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

enumerate(iterable, start=0)

المعاملات

iterable

كائن يدعم التّكرار (iteration)، مثل القوائم، والصّفوف والمولّدات والمكرّرات وغيرها.

start

العدد الذي سيبدأ منه التّرقيم، القيمة الافتراضيّة هي 0.

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

كائن قابل للتّكرار من النّوع enumerate. يكون عبارة عن أزواج، الجزء الأول يكون رقم العنصر، والجزء الثّاني يكون العنصر نفسه.

أمثلة

المثال التّالي يوضّح كيفيّة عمل هذه الدّالة:

>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] # قائمة بايثون عاديّة
>>> list(enumerate(seasons)) # نُحوّل الكائن النّاتج إلى قائمة لننظر ما بداخلها من عناصر
[(0, 'Spring'), (1, 'Summer'), (2, 'Fall'), (3, 'Winter')]
>>> list(enumerate(seasons, start=1)) # هنا نضع عددًا بدئيًّا مُخالفًا لما هو افتراضيّ
[(1, 'Spring'), (2, 'Summer'), (3, 'Fall'), (4, 'Winter')]

ملاحظات

الدّالة enumerate()‎ مُكافئة لما يلي:

def enumerate(sequence, start=0):
    n = start
    for elem in sequence:
        yield n, elem
        n += 1

انظر أيضًا

• المكرِّرات Iterators في بايثون.
• الأعداد الصحيحة في بايثون.

مصادر

• قسم الدالة enumerate في صفحة Functions في توثيق Python الرسمي.