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

يعيد التابع 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) إلى البداية.

مصادر

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