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

من موسوعة حسوب
< Python‏ | dict
اذهب إلى التنقل اذهب إلى البحث

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

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

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()‎: حذف زوج (مفتاح، قيمة) عشوائيًا من القاموس.

مصادر