عرض مصدر Python/enumerate

<noinclude>{{DISPLAYTITLE:الدالة <code>enumerate()‎</code> في بايثون}}</noinclude>
تعيد الدّالة <code>enumerate()‎</code> كائنًا قابلًا للتّكرار من النّوع <code>enumerate</code>. وتُستخدم لترقيم الكائنات القابلة للتّكرار.

== البنية العامة ==
<syntaxhighlight lang="python3">
enumerate(iterable, start=0)
</syntaxhighlight>

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

=== <code>start</code> ===
العدد الذي سيبدأ منه التّرقيم، القيمة الافتراضيّة هي  <code>0</code>.

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

== أمثلة ==
المثال التّالي يوضّح كيفيّة عمل هذه الدّالة:
<syntaxhighlight lang="python3">
>>> 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')]
</syntaxhighlight>

== ملاحظات ==
الدّالة <code>enumerate()‎</code> مُكافئة لما يلي:
<syntaxhighlight lang="python3">
def enumerate(sequence, start=0):
    n = start
    for elem in sequence:
        yield n, elem
        n += 1
</syntaxhighlight>

== انظر أيضًا ==
* [[Python/iterators|المكرِّرات Iterators في بايثون]].
* [[Python/int|الأعداد الصحيحة في بايثون]].

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