التابع Enumerator.peek_values في روبي
< Ruby | Enumerator
يعيد التابع peek_values مصفوفة تحوي القيمة التالية في المُعدِّد الذي استدعي معه بشكل مشابه للتابع next_values ولكن لا يحرِّك موضع المؤشر الداخلي للأمام. إن كان المؤشر موجود مسبقًا في النهاية، فسيُطلَق الاستثناء StopIteration.
البنية العامة
peek_values → array
القيمة المعادة
تعاد مصفوفة تحوي القيمة التالية في المُعدِّد المعطى.
أمثلة
مثال على استعمال التابع peek_values:
o = Object.new
def o.each
yield
yield 1
yield 1, 2
end
e = o.to_enum
p e.peek_values #=> []
e.next
p e.peek_values #=> [1]
p e.peek_values #=> [1]
e.next
p e.peek_values #=> [1, 2]
e.next
p e.peek_values # raises StopIteration
انظر أيضًا
- التابع
next_values: يعيد مصفوفة تحوي الكائن التالي في المُعدِّد الذي استدعي معه، ويحرك موضع المؤشر الداخلي للأمام خطوةً واحدةً. - التابع
peek: يعيد الكائن التالي في المُعدِّد الذي استدعي معه ولكن لا يحرِّك موضع المؤشر الداخلي للأمام. - التابع
rewind: يعيد موضع مؤشر السلسلة التعدادية (enumeration sequence) إلى البداية.