التابع Enumerator.next في روبي

يعيد التابع next الكائن التالي في المُعدِّد الذي استدعي معه، ويحرك موضع المؤشر الداخلي للأمام خطوة واحدة. عند وصول المؤشر إلى النهاية، يُطلَق الاستثناء StopIteration.

البنية العامة

next → object

القيمة المعادة

يعاد الكائن التالي في المُعدِّد المعطى.

أمثلة

مثال على استعمال التابع next:

a = [1,2,3]
e = a.to_enum
p e.next   #=> 1
p e.next   #=> 2
p e.next   #=> 3
p e.next   #=> StopIteration

انتبه إلى أنَّ السلسلة التعدادية المعادة عبر next لا تؤثر على التوابع التعدادية الغير خارجية (non-external enumeration methods) إلا إن كان لتوابع التكرار الأساسية نفسها آثارًا جانبية مثل التابع IO.each_line.

انظر أيضًا

• التابع feed: يضبط القيمة المراد إعادتها عبر الاستدعاء yield التالي داخل e.
• التابع next_values: يعيد مصفوفة تحوي الكائن التالي في المُعدِّد الذي استدعي معه، ويحرك موضع المؤشر الداخلي للأمام خطوةً واحدةً.

مصادر

• قسم التابع next في الصنف Enumerator في توثيق روبي الرسمي.