عرض مصدر Python/sum

<noinclude>{{DISPLAYTITLE:الدالة <code>sum()‎</code> في بايثون}}</noinclude>
تعيد الدّالة <code>sum()‎</code> مجموع عناصر الكائن القابل للتكرار المُعطى إضافةً إلى قيمة بدئيّة إن مُرِّرَت.

== البنية العامة ==
<syntaxhighlight lang="python3">
sum(iterable[, start])
</syntaxhighlight>

== المعاملات ==
=== <code>iterable</code> ===
الكائن القابل للتّكرار المرغوب جمع عناصره التي تكون عادةً قيمًا عدديّة.

=== <code>start</code> ===
مُعامل اختياريّ يُمثّل القيمة البدئيّة التي ستُضاف إلى المجموع في بدايته، قيمته الافتراضيّةُ <code>0</code>، ولا يجوز أن تكون قيمته سلسلةً نصيّة.

== القيمة المعادة ==
مجموع عناصر الكائن القابل للتّكرار إضافةً إلى القيمة البدئيّة.

== أمثلة ==
المثال التّالي يوضّح كيفيّة عمل هذه الدّالة:
<syntaxhighlight lang="python3">
>>> sum([1, 2, 3]) # مجموع قائمة أعداد
6
>>> sum([1, 2, 3], 10) # إضافة قيمة بدئيّة إلى المجموع
16
</syntaxhighlight>

== ملاحظات ==
* 
* تُجمع عناصر الكائن القابل للتّكرار من اليسار إلى اليمين.
* هناك بدائل أفضل من الدّالة <code>sum()‎</code> في بعض الحالات. الطريقة المُفضّلة والسّريعة لجمع عدّة سلاسل نصيّة هي الاستدعاء <code>‎'‎'‎.‎join‎(‎sequence‎)‎‎</code>. لجمع أعداد عشريّة بدقّة أكثر، انظر الدّالة <code>[[Python/math/fsum|math.fsum]]</code>. ولجمع سلسلة من الكائنات القابلة للتّكرار، ألق نظرة على <code>[[Python/itertools/chain|itertools.chain]]</code>.

== انظر أيضًا ==
* [[Python/math/fsum|math.fsum]].
* التابع <code>[[Python/itertools/chain|itertools.chain()‎]]</code>: يعيد مُكرّرًا يُعيد عناصر الكائن القابل للتكرار الأول حتى تنتهيَ عناصره، ثمّ ينتقل إلى الكائن القابل للتّكرار التّالي إلى أن تنتهي قيّمه وهكذا…
* التابع <code>[[Python/str/join|str.join()‎]]</code>: يعيد السلسلة النصية الناتجة عن ربط السلاسل النصية التابعة لكائن قابل للتكرار (iterable).

== مصادر ==
* [https://docs.python.org/3/library/functions.html#sum قسم الدالة sum في صفحة Functions في توثيق Python الرسمي].
[[تصنيف:Python]]
[[تصنيف:Python Function]]
[[تصنيف:Python Built-in Functions]]