عرض مصدر Ruby/Enumerator/next values

<noinclude>{{DISPLAYTITLE:التابع <code>Enumerator.next_values</code> في روبي}}</noinclude>
يعيد التابع <code>next_values</code> <nowiki/>[[Ruby/Array|مصفوفة]] تحوي الكائن التالي في [[Ruby/Enumerator|المُعدِّد]] الذي استدعي معه، ويحرك موضع المؤشر الداخلي للأمام خطوةً واحدةً. عند وصول المؤشر إلى النهاية، يُطلَق الاستثناء <code>[[Ruby/StopIteration|StopIteration]]</code>.

يمكن استعمال هذا التابع للتمييز بين <code>yield</code> و <code>yield nil</code>.

==البنية العامة==
<syntaxhighlight lang="ruby">next_values → array</syntaxhighlight>
==القيمة المعادة==
تعاد [[Ruby/Array|مصفوفة]] تحوي الكائن التالي في [[Ruby/Enumerator|المُعدِّد]] المعطى.

== أمثلة ==
مثال على استعمال التابع <code>next_values</code>:<syntaxhighlight lang="ruby">
o = Object.new
def o.each
  yield
  yield 1
  yield 1, 2
  yield nil
  yield [1, 2]
end
e = o.to_enum
p e.next_values
p e.next_values
p e.next_values
p e.next_values
p e.next_values
e = o.to_enum
p e.next
p e.next
p e.next
p e.next
p e.next

## yield args       next_values      next
#  yield            []               nil
#  yield 1          [1]              1
#  yield 1, 2       [1, 2]           [1, 2]
#  yield nil        [nil]            nil
#  yield [1, 2]     [[1, 2]]         [1, 2]
</syntaxhighlight>انتبه إلى أنَّ التابع <code>next_values</code> لا يؤثر على التوابع التعدادية الغير خارجية (non-external enumeration methods) إلا إن كان لتوابع التكرار الأساسية نفسها آثارًا جانبية مثل التابع <code>[[Ruby/IO/each line|IO.each_line]]</code>.

==انظر أيضًا==
*التابع <code>[[Ruby/Enumerator/feed|feed]]</code>: يضبط القيمة المراد إعادتها عبر الاستدعاء <code>yield</code> التالي داخل <code>e</code>.
*التابع <code>[[Ruby/Enumerator/next|next]]</code>: يعيد الكائن التالي في [[Ruby/Enumerator|المُعدِّد]] الذي استدعي معه، ويحرك موضع المؤشر الداخلي للأمام خطوة واحدة.
==مصادر==
*[http://ruby-doc.org/core-2.5.1/Enumerator.html#method-i-next_values قسم التابع next_values في الصنف Enumerator في توثيق روبي الرسمي.]
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Enumerator]]