الفرق بين المراجعتين لصفحة: «Python/sum»

من موسوعة حسوب
إضافة الصّفحة
 
لا ملخص تعديل
 
(3 مراجعات متوسطة بواسطة مستخدم واحد آخر غير معروضة)
سطر 15: سطر 15:


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


== أمثلة ==
== أمثلة ==
سطر 27: سطر 27:


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

المراجعة الحالية بتاريخ 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).

مصادر