عرض مصدر Ruby/Enumerable/sum

<noinclude>{{DISPLAYTITLE: التابع <code>Enumerable.sum</code> في روبي}}</noinclude>
يعيد التابع <code>sum</code> مجموع عناصر [[Ruby/Enumerable|الكائن القابل للتعداد]] الذي استدعي معه.

إن أعطيت كتلة، فستُطبَّق الكتلة على كل عنصر قبل الإضافة.

قد لا يأخذ التابع <code>sum</code> بالحسبان إعادة تعريف المعاملات <code>+</code> مثل <code>[[Ruby/Integer/plus|+]]</code> في الصنف <code>[[Ruby/Integer|Integer]]</code>.

==البنية العامة==
<syntaxhighlight lang="ruby">sum(init=0) → number
sum(init=0) {|e| expr } → number</syntaxhighlight>

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

=== <code>init</code> ===
القيمة البدائية المراد البدء بها في عملية الجمع. القيمة الافتراضية هي: 0.

==القيمة المعادة==
يعاد عدد يمثِّل ناتج جمع عناصر الكائن القابل للتعداد المعطى.
==أمثلة==
مثال على استعمال التابع <code>sum</code>:<syntaxhighlight lang="ruby">
{ 1 => 10, 2 => 20 }.sum {|k, v| k * v }  #=> 50
(1..10).sum                               #=> 55
(1..10).sum {|v| v * 2 }                  #=> 110
[Object.new].each.sum                     #=> TypeError
</syntaxhighlight>يمكن استعمال هذا التابع مع الكائنات الغير عددية عبر تحديد المعامل <code>init</code> بشكل صريح:<syntaxhighlight lang="ruby">
{ 1 => 10, 2 => 20 }.sum([])                   #=> [1, 10, 2, 20]
"a\nb\nc".each_line.lazy.map(&:chomp).sum("")  #=> "abc"
</syntaxhighlight>

==انظر أيضًا==
*التابع <code>[[Ruby/Enumerable/group by|group_by]]</code>: يجمِّع عناصر الكائن القابل للتعداد الذي استدعي معه في مجموعات بحسب النتيجة المقابلة لكل عنصر التي تعيدها الكتلة المعطاة بعد تمريره إليها.
*التابع <code>[[Ruby/Enumerable/max|max]]</code>: يبحث عن قيمة أكبر عنصر من عناصر [[Ruby/Enumerator|الكائن القابل للتعداد]] الذي استدعي معه ثم يعيده.
*التابع <code>[[Ruby/Enumerable/reduce|reduce]]</code>: يجمع جميع عناصر الكائن القابل للتعداد الذي استدعي معه عبر تطبيق عملية ثنائية تُحدَّد بوساطة كتلة أو <nowiki/>[[Ruby/Symbol|رمز]] يسمي تابعًا أو معاملًا.
==مصادر==
*[http://ruby-doc.org/core-2.5.1/Enumerable.html#method-i-sum قسم التابع sum في الصنف Enumerable في توثيق روبي الرسمي.]
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Enumerable]]