Python/sum

تعيد الدّالة sum()‎ مجموع عناصر الكائن القابل للتكرار المُعطى إضافةً إلى قيمة بدئيّة إن مُرِّرَت.

البنية العامة

sum(iterable[, start])

المعاملات

iterable

الكائن القابل للتّكرار المرغوب جمع عناصره التي تكون عادةً قيمًا عدديّة.

start

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

القيمة المعادة

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

أمثلة

المثال التّالي يوضّح كيفيّة عمل هذه الدّالة:

>>> sum([1, 2, 3]) # مجموع قائمة أعداد
6
>>> sum([1, 2, 3], 10) # إضافة قيمة بدئيّة إلى المجموع
16

ملاحظات

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

انظر أيضًا

• math.fsum.
• itertools.chain.
• الدالة str.join()‎ في بايثون.

مصادر

• قسم الدالة sum في صفحة Functions في توثيق Python الرسمي.