الفرق بين المراجعتين ل"Python/next"
< Python
اذهب إلى التنقل
اذهب إلى البحث
(إضافة الصّفحة) |
|||
سطر 14: | سطر 14: | ||
مُعامل اختياريّ. | مُعامل اختياريّ. | ||
− | تُعاد قيمته عندما تنتهي قيم المُكرّر، وإن لم يُمرّر، فسيُطلَق استثناء [[Python/StopIteration|StopIteration]]. | + | تُعاد قيمته عندما تنتهي قيم المُكرّر، وإن لم يُمرّر، فسيُطلَق استثناء <code>[[Python/built-in exceptions#StopIteration|StopIteration]]</code>. |
== القيمة المعادة == | == القيمة المعادة == | ||
سطر 59: | سطر 59: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
− | |||
− | |||
* [[Python/iterators|المكرِّرات Iterators في بايثون]]. | * [[Python/iterators|المكرِّرات Iterators في بايثون]]. | ||
+ | * الدالة <code>[[Python/iter|iter()]]</code>: تعيد مُكرّرًا حسب المُعاملات المُعطاة. | ||
== مصادر == | == مصادر == |
المراجعة الحالية بتاريخ 13:04، 10 يونيو 2018
تعيد الدّالة next()
القيمة التّالية من المُكرّر المٌعطى عبر استدعاء تابعه الخاصّ __next__()
.
البنية العامة
next(iterator[, default])
المعاملات
iterator
المُكرّر المرُاد الحصول على قيمته التّالية.
default
مُعامل اختياريّ.
تُعاد قيمته عندما تنتهي قيم المُكرّر، وإن لم يُمرّر، فسيُطلَق استثناء StopIteration
.
القيمة المعادة
القيمة التّاليّة للمُكرّر أو القيمة الافتراضيّة المُعطاة للمُعامل default
عندما تنتهي قيم المُكرّر.
أمثلة
المثال التّالي يوضّح كيفيّة عمل هذه الدّالة:
>>> name = 'Yousuf'
>>> iterator = iter(name)
>>> iterator
<str_iterator object at 0x7f314d904fd0>
>>> next(iterator)
'Y'
>>> next(iterator)
'o'
>>> next(iterator)
'u'
>>> next(iterator)
's'
>>> next(iterator)
'u'
>>> next(iterator)
'f'
>>> next(iterator) # انتهت قيم المُكرّر
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
StopIteration
>>> chars = iter('ABCD')
>>> next(chars, '0')
'A'
>>> next(chars, '0')
'B'
>>> next(chars, '0')
'C'
>>> next(chars, '0')
'D'
>>> next(chars, '0') # انتهت قيم المُكرّر
'0'
>>> next(chars, '0')
'0'
انظر أيضًا
- المكرِّرات Iterators في بايثون.
- الدالة
iter()
: تعيد مُكرّرًا حسب المُعاملات المُعطاة.