عرض مصدر Python/dict/setdefault

<noinclude>{{DISPLAYTITLE:التابع <code>dict.setdefault()‎</code> في بايثون}}</noinclude>
يعيد التابع قيمة المفتاح المحدد في المعاملات إن كان موجودًا. أما إن كان المفتاح غير موجود في القاموس فإنّ التابع يضيف المفتاح مع القيمة المحدّدة له إلى القاموس.

== البنية العامة ==
<syntaxhighlight lang="python3">
dict.setdefault(key[, default])
</syntaxhighlight>

== المعاملات ==

=== <code>key</code> ===
المفتاح الذي سيبحث عنه التابع في القاموس.

=== <code>default</code> ===
القيمة التي ستسند إلى المفتاح الذي سيضاف إلى القاموس، في حال عدم عثور التابع على المفتاح <code>key</code>.

== القيمة المعادة ==
يعيد التابع قيمة المفتاح المحدد في المعاملات إن كان موجودًا، وتعيد القيمة <code>None</code> إن كان المفتاح المحدد غير موجود في القاموس وكانت قيمة المعامل <code>default</code> غير محدّدة، أما إذا كانت قيمة هذا المعامل محدّدة فسيعيد التابع تلك القيمة.

== أمثلة ==
يبين المثال التالي النتائج المعادة من تطبيق التابع:

<syntaxhighlight lang="python3">
>>> employee = {'first-name': 'Ahmed', 'last-name': 'Jamil', 'age': 28}
>>> employee.setdefault('age')
28
>>> employee.setdefault('height')
>>> employee
{'first-name': 'Ahmed', 'last-name': 'Jamil', 'age': 28, 'height': None}
>>> employee.setdefault('salary', 4000.0)
4000.0
>>> employee
{'first-name': 'Ahmed', 'last-name': 'Jamil', 'age': 28, 'height': None, 'salary': 4000.0}
</syntaxhighlight>

== انظر أيضًا ==
* [[Python/dict|القواميس في بايثون.]]

== مصادر ==
* [https://docs.python.org/3/library/stdtypes.html#dict.setdefault قسم setdefault في صفحة Types في توثيق بايثون الرسمي.]
[[تصنيف:Python]]
[[تصنيف:Python Method]]
[[تصنيف:Python Types]]
[[تصنيف:Python Dict]]