عرض مصدر Ruby/Enumerator/with object

<noinclude>{{DISPLAYTITLE: التابع <code>Enumerator.with_object</code> في روبي}}</noinclude>
يكرِّر التابع <code>with_object</code> الكتلة المعطاة على كل عنصر من عناصر [[Ruby/Enumerator|المُعدِّد]] الذي استدعي معه مع كائن اعتباطي (الكائن المُمرَّر إليه) ثم يعيد هذا الكائن.

إن لم تُعطَ الكتلة، فسيعيد التابع كائنًا جديدًا من النوع <code>[[Ruby/Enumerator|Enumerator]]</code>.

==البنية العامة==
<syntaxhighlight lang="ruby">with_object(obj) {|(*args), obj| ... }
with_object(obj)</syntaxhighlight>

== المعاملات ==

=== <code>obj</code> ===
الكائن الذي سيُكرَّر مع كل عنصر من عناصر الكائن المعطى.

==القيمة المعادة==
يعاد الكائن <code>obj</code> المعطى، أو يعاد كائن جديد من النوع <code>[[Ruby/Enumerator|Enumerator]]</code> إن لم تُعطَ أية كتلة.
==أمثلة==
مثال على استعمال التابع <code>with_object</code>:<syntaxhighlight lang="ruby">
to_three = Enumerator.new do |y|
  3.times do |x|
    y << x
  end
end

to_three_with_string = to_three.with_object("foo")
to_three_with_string.each do |x,string|
  puts "#{string}: #{x}"
end

# => foo:0
# => foo:1
# => foo:2
</syntaxhighlight>
==انظر أيضًا==
*التابع <code>[[Ruby/Enumerator/each with object|each_with_object]]</code>: يكرر الكتلة المعطاة على كل عنصر من عناصر الكائن الذي استدعي معه مع كائن آخر اعتباطي (الكائن المُمرَّر إليه).

*التابع <code>[[Ruby/Enumerator/with index|with_index]]</code>: يكرر الكتلة المعطاة على كل عنصر من عناصر [[Ruby/Enumerator|المُعدِّد]] الذي استدعي معه مع فهارسها والتي تبدأ عند موضع محدَّد.
==مصادر==
*[http://ruby-doc.org/core-2.5.1/Enumerator.html#method-i-next_values قسم التابع with_object في الصنف Enumerator في توثيق روبي الرسمي.]
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Enumerator]]