الدالة next() في بايثون
< Python
تعيد الدّالة 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(): تعيد مُكرّرًا حسب المُعاملات المُعطاة.