الدالة 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()‎: يعيد السلسلة النصية الناتجة عن ربط السلاسل النصية التابعة لكائن قابل للتكرار (iterable).

مصادر

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