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

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

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

peek → object

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

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

أمثلة

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

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

انظر أيضًا

• التابع next: يعيد الكائن التالي في المُعدِّد الذي استدعي معه، ويحرك موضع المؤشر الداخلي للأمام خطوة واحدة.
• التابع peek_values: يعيد مصفوفة تحوي القيمة التالية في المُعدِّد الذي استدعي معه بشكل مشابه للتابع next_values ولكن لا يحرِّك موضع المؤشر الداخلي للأمام.
• التابع rewind: يعيد موضع مؤشر السلسلة التعدادية (enumeration sequence) إلى البداية.

مصادر

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