الدالة next()‎ في بايثون

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

مصادر

• قسم الدالة next في صفحة Functions في توثيق Python الرسمي.