التابع Enumerator.peek في روبي
< Ruby | Enumerator
يعيد التابع 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) إلى البداية.