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

يحذف التابع المفتاح المحدد في المعاملات ويعيد قيمته.

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

dict.pop(key[, default])

المعاملات

key

المفتاح المراد حذفه.

default

القيمة التي يعيدها التابع في حال عدم العثور على المفتاح المطلوب.

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

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

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

أمثلة

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

>>> employee = {'first-name': 'Ahmed', 'last-name': 'Jamil', 'age': 28}
>>> employee.pop('age')
28
>>> employee
{'first-name': 'Ahmed', 'last-name': 'Jamil'}
>>> employee.pop('height', '175 cm')
'175 cm'
>>> employee.pop('height')
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
KeyError: 'height'

انظر أيضًا

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

• التابع dict.popitem()‎: حذف زوج (مفتاح، قيمة) عشوائيًا من القاموس.

مصادر

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