عرض مصدر Python/functools/reduce

<noinclude>{{DISPLAYTITLE:الدالة <code>functools.reduce()‎</code> في بايثون}}</noinclude>
تُطبّق الدّالة <code>functools.reduce()‎</code> دالّة تأخذ مُعاملين بتراكب لعناصر الكائن القابل للتّكرار المُعطى، من اليسار إلى اليمين لتخفيض العناصر إلى قيمة واحدة (كجمع عدّة مبالغ للحصول على مبلغ إجماليّ واحد مثلًا).


== البنية العامة ==
<syntaxhighlight lang="python3">
functools.reduce(function, iterable[, initializer])
</syntaxhighlight>

== المعاملات ==
=== <code>function</code> ===
الدّالة المُراد تطبيقها على عناصر الكائن القابل للتّكرار.

=== <code>iterable</code> ===
الكائن القابل للتّكرار.

=== <code>initializer</code> ===
قيمة بدئيّة تُضاف إلى بداية العناصر قبل بدء الحساب، وتكون كذلك قيمة افتراضيّة عندما يكون  الكائن القابل للتّكرار فارغًا.

إن لم تُمرّر قيمة للمُعامل <code>initializer</code> واحتوى الكائن القابل للتّكرار على عنصر واحد فقط، فسيُعاد ذات العنصر.

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

== أمثلة ==
المثال التّالي يوضّح كيفيّة عمل هذه الدّالة، هنا يجمع تعبير lambda آخر نتيجة (أي المُعامل y) مع كلّ عنصر من العناصر (المُعامل x):
<syntaxhighlight lang="python3">
>>> functools.reduce(lambda x, y: x+y, [1, 2, 3, 4, 5])
15
</syntaxhighlight>

الاستدعاء أعلاه يقوم بالعمليّة الحسابيّة التّاليّة:
<syntaxhighlight lang="python3">
((((1+2)+3)+4)+5)
</syntaxhighlight>

== ملاحظات ==
الدّالة مُكافئة لما يلي:
<syntaxhighlight lang="python3">
def reduce(function, iterable, initializer=None):
    it = iter(iterable)
    if initializer is None:
        value = next(it)
    else:
        value = initializer
    for element in it:
        value = function(value, element)
    return value
</syntaxhighlight>

== انظر أيضًا ==
* [[Python/defining-functions|تعريف الدوال في بايثون]].

== مصادر ==
* [https://docs.python.org/3/library/functools.html#functools.reduce قسم الدالة functools.reduce في توثيق Python الرسمي].
[[تصنيف:Python]]
[[تصنيف:Python Function]]
[[تصنيف:Python functools]]