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

من موسوعة حسوب
< Python‏ | dict
مراجعة 11:58، 10 يونيو 2018 بواسطة عبد اللطيف ايمش (نقاش | مساهمات) (استبدال النص - ':الدالة' ب':التابع')
(فرق) → مراجعة أقدم | المراجعة الحالية (فرق) | مراجعة أحدث ← (فرق)

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

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

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

مصادر