الفرق بين المراجعتين لصفحة: «Python/enumerate»
< Python
ط ←أمثلة |
لا ملخص تعديل |
||
سطر 1: | سطر 1: | ||
تعيد الدّالة <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>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