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

من موسوعة حسوب
لا ملخص تعديل
 
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:الدالة <code>enumerate()‎</code> في بايثون}}</noinclude>
تعيد الدّالة <code>enumerate()‎</code> كائنًا قابلًا للتّكرار من النّوع <code>enumerate</code>. وتُستخدم لترقيم الكائنات القابلة للتّكرار.
تعيد الدّالة <code>enumerate()‎</code> كائنًا قابلًا للتّكرار من النّوع <code>enumerate</code>. وتُستخدم لترقيم الكائنات القابلة للتّكرار.
 
==البنية العامة==
== البنية العامة ==
<syntaxhighlight lang="python3">
<syntaxhighlight lang="python3">
enumerate(iterable, start=0)
enumerate(iterable, start=0)
</syntaxhighlight>
</syntaxhighlight>
 
==المعاملات==
== المعاملات ==
===<code>iterable</code>===
=== <code>iterable</code> ===
كائن يدعم التّكرار (iteration)، مثل القوائم، والصّفوف والمولّدات والمكرّرات وغيرها.
كائن يدعم التّكرار (iteration)، مثل القوائم، والصّفوف والمولّدات والمكرّرات وغيرها.
 
===<code>start</code>===
=== <code>start</code> ===
العدد الذي سيبدأ منه التّرقيم، القيمة الافتراضيّة هي <code>0</code>.
العدد الذي سيبدأ منه التّرقيم، القيمة الافتراضيّة هي <code>0</code>.
==القيمة المعادة==
 
== القيمة المعادة ==
كائن قابل للتّكرار من النّوع <code>enumerate</code>. يكون عبارة عن أزواج، الجزء الأول يكون رقم العنصر، والجزء الثّاني يكون العنصر نفسه.
كائن قابل للتّكرار من النّوع <code>enumerate</code>. يكون عبارة عن أزواج، الجزء الأول يكون رقم العنصر، والجزء الثّاني يكون العنصر نفسه.
 
==أمثلة==
== أمثلة ==
المثال التّالي يوضّح كيفيّة عمل هذه الدّالة:<syntaxhighlight lang="python3">
المثال التّالي يوضّح كيفيّة عمل هذه الدّالة:
<syntaxhighlight lang="python3">
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] # قائمة بايثون عاديّة
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] # قائمة بايثون عاديّة
>>> list(enumerate(seasons)) # نُحوّل الكائن النّاتج إلى قائمة لننظر ما بداخلها من عناصر
>>> list(enumerate(seasons)) # نُحوّل الكائن النّاتج إلى قائمة لننظر ما بداخلها من عناصر
سطر 26: سطر 19:
[(1, 'Spring'), (2, 'Summer'), (3, 'Fall'), (4, 'Winter')]
[(1, 'Spring'), (2, 'Summer'), (3, 'Fall'), (4, 'Winter')]
</syntaxhighlight>
</syntaxhighlight>
 
==ملاحظات==
== ملاحظات ==
الدّالة <code>enumerate()‎</code> مُكافئة لما يلي:<syntaxhighlight lang="python3">
الدّالة <code>enumerate()‎</code> مُكافئة لما يلي:
<syntaxhighlight lang="python3">
def enumerate(sequence, start=0):
def enumerate(sequence, start=0):
     n = start
     n = start
سطر 36: سطر 27:
         n += 1
         n += 1
</syntaxhighlight>
</syntaxhighlight>
 
==انظر أيضًا==
== انظر أيضًا ==
*[[Python/iterators|المكرِّرات Iterators في بايثون]].
* [[Python/iterators|المكرِّرات Iterators في بايثون]].
*[[Python/int|الأعداد الصحيحة في بايثون]].
* [[Python/int|الأعداد الصحيحة في بايثون]].
==مصادر==
 
*[https://docs.python.org/3/library/functions.html#enumerate قسم الدالة enumerate في صفحة Functions في توثيق Python الرسمي].<noinclude>{{DISPLAYTITLE:الدالة <code>enumerate()‎</code> في بايثون}}</noinclude>
== مصادر ==
* [https://docs.python.org/3/library/functions.html#enumerate قسم الدالة enumerate في صفحة Functions في توثيق Python الرسمي].
[[تصنيف:Python]]
[[تصنيف:Python]]
[[تصنيف:Python Function]]
[[تصنيف:Python Function]]
[[تصنيف:Python Built-in Functions]]
[[تصنيف:Python Built-in Functions]]

المراجعة الحالية بتاريخ 13:45، 21 مايو 2018

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

انظر أيضًا

مصادر