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