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

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

تُستعمل لإنشاء دالّة جزئيّة من دالّة بتمرير قيم افتراضيّة ثابتة لها.

== البنية العامة ==
<syntaxhighlight lang="python3">
functools.partial(func, *args, **keywords)
</syntaxhighlight>

== المعاملات ==
=== <code>func</code> ===
الدّالة المرغوب إنشاء دالّة جزئيّة منها.

=== <code>args</code> ===
المُعاملات التي ستُمرّر.

=== <code>keywords</code> ===
المُعاملات المفتاحيّة التي ستُمرّر.

== القيمة المعادة ==
كائن <code>partial</code> يتصرّف كالدّالة المُعطاة عند استدعائها بما مُرّر من مُعاملات ومُعاملات مفتاحيّة ويُعدّ دالّة جزئيّة من الدّالة الأصليّة ذات قيم ثابتة مُمرّرة مُسبقًا.

كائنات <code>partial</code> تملك ثلاث خاصيّات قابلة للقراءة فقط (read-only):

=== <code>partial.func</code> ===
كائن قابل للاستدعاء أو دالّة. ستُوجّه الاستدعاءات إلى الكائن <code>partial</code> إلى الكائن <code>partial.func</code> مع مُعاملات وكلمات مفتاحيّة جديدة.

=== <code>partial.args</code> ===
المُعاملات المكانيّة (positional arguments، أي المُعاملات التي تُمرّر قيَمُها دون ذكر اسمها) التي ستُضاف إلى أقصى يسار المُعاملات التي تُمرّر إلى الكائن <code>partial</code>.

=== <code>partial.keywords</code> ===
مُعاملات الكلمات المفتاحيّة التي ستُمرّر عندما يُستدعى الكائن <code>partial</code>.

كائنات <code>partial</code> مثلُها مثل الدّوال، إذ تكون كائناتٍ قابلة للاستدعاء، وذات إحالة ضعيفة (weak referencable)، ويُمكن لها أن تمتلك خاصيّات مُعيّنة. لكن هناك بعض الفروقات المُهمّة، على سبيل المثال، الخاصيّتان <code>‎__name__‎</code> و<code>‎__doc__‎</code> لا تُنشآن تلقائيًّا. إضافةً إلى أنّ كائنات <code>partial</code> المُعرفّة في الأصناف تتصرّف مثل التّوابع السّاكنة ولا تتحوّل إلى توابع مُرتبطة (bound methods) عند البحث عن خاصيّات النّسخة.

== أمثلة ==
تُستخدم الدّالة <code>functools.partial()‎</code> لإنشاء دالّة جزئيّة تُجمّد جزءًا ممّا يُمرّر إلى الدّالة من مُعاملات، ما يُنشئُ كائنًا ذا توقيع أبسط. على سبيل المثال، يُمكن استعمال الدّالة  <code>functools.partial()‎</code> لإنشاء كائن قابل للاستدعاء يتصرّف مثل الدّالة <code>int()‎</code> بمُعامل أساس (base) يُساوي افتراضيًّا القيمة 2:

<syntaxhighlight lang="python3">
>>> from functools import partial
>>> basetwo = partial(int, base=2)
>>> basetwo('10010')
18
</syntaxhighlight>

== ملاحظات ==
الدّالة مُكافئة تقريبًا لما يلي:
<syntaxhighlight lang="python3">
def partial(func, *args, **keywords):
    def newfunc(*fargs, **fkeywords):
        newkeywords = keywords.copy()
        newkeywords.update(fkeywords)
        return func(*args, *fargs, **newkeywords)
    newfunc.func = func
    newfunc.args = args
    newfunc.keywords = keywords
    return newfunc
</syntaxhighlight>

== انظر أيضًا ==
* [[Python/functools/partialmethod|functools.partialmethod]]: لتابعٍ جزئيّ عوضًا عن دالّة.
* [[Python/int|الأعداد الصّحيحة في بايثون]].
* [[Python/defining-functions|تعريف الدوال في بايثون]].

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