الدالة sum()‎ في بايثون

من موسوعة حسوب
< Python
مراجعة 13:41، 10 يونيو 2018 بواسطة عبد اللطيف ايمش (نقاش | مساهمات)
(فرق) → مراجعة أقدم | المراجعة الحالية (فرق) | مراجعة أحدث ← (فرق)
اذهب إلى التنقل اذهب إلى البحث

تعيد الدّالة 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).

مصادر