التابع dict.setdefault()‎ في بايثون

يعيد التابع قيمة المفتاح المحدد في المعاملات إن كان موجودًا. أما إن كان المفتاح غير موجود في القاموس فإنّ التابع يضيف المفتاح مع القيمة المحدّدة له إلى القاموس.

البنية العامة

dict.setdefault(key[, default])

المعاملات

key

المفتاح الذي سيبحث عنه التابع في القاموس.

default

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

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

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

أمثلة

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

>>> 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}

انظر أيضًا

• القواميس في بايثون.

مصادر

• قسم setdefault في صفحة Types في توثيق بايثون الرسمي.