الدالة sum()
في بايثون
< Python
تعيد الدّالة 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.