الفرق بين المراجعتين لصفحة: «Python/dict/pop»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الدالة <code>dict.pop()</code> في بايثون}}</noinclude> تحذف الدالة المفتاح المحدد في المعاملا...' |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الدالة <code>dict.pop()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:الدالة <code>dict.pop()</code> في بايثون}}</noinclude> | ||
يحذف التابع المفتاح المحدد في المعاملات ويعيد قيمته. | |||
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="python3"> | <syntaxhighlight lang="python3"> | ||
dict.pop(key[, default]) | |||
</syntaxhighlight> | </syntaxhighlight> | ||
| سطر 12: | سطر 12: | ||
=== <code>default</code> === | === <code>default</code> === | ||
القيمة التي | القيمة التي يعيدها التابع في حال عدم العثور على المفتاح المطلوب. | ||
== القيمة المعادة == | == القيمة المعادة == | ||
إن كان المفتاح المراد حذفه موجودًا في القاموس فإنّ | إن كان المفتاح المراد حذفه موجودًا في القاموس فإنّ التابع يحذفه ويعيد قيمته، وإن لم يكن المفتاح موجودًا فإنّ التابع يعيد قيمة المعامل <code>default</code>. | ||
في حال لم يكن المفتاح المراد حذفه موجودًا في القاموس ولم يمتلك المعامل <code>default</code> أيّ قيمة فإنّ | في حال لم يكن المفتاح المراد حذفه موجودًا في القاموس ولم يمتلك المعامل <code>default</code> أيّ قيمة فإنّ التابع يطلق الخطأ <code>[[Python/built-in exceptions#KeyError|KeyError]]</code>. | ||
== أمثلة == | == أمثلة == | ||
يوضح المثال التالي النتائج المعادة من تطبيق | يوضح المثال التالي النتائج المعادة من تطبيق التابع: | ||
<syntaxhighlight lang="python3"> | <syntaxhighlight lang="python3"> | ||
| سطر 40: | سطر 40: | ||
* [[Python/dict|القواميس في بايثون.]] | * [[Python/dict|القواميس في بايثون.]] | ||
*التابع <code>[[Python/dict/popitem|dict.popitem()]]</code>: حذف زوج (مفتاح، قيمة) عشوائيًا من القاموس. | |||
== مصادر == | == مصادر == | ||
* [https://docs.python.org/3/library/stdtypes.html#dict.pop قسم pop في صفحة Types في توثيق بايثون الرسمي.] | * [https://docs.python.org/3/library/stdtypes.html#dict.pop قسم pop في صفحة Types في توثيق بايثون الرسمي.] | ||
مراجعة 10:54، 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(): حذف زوج (مفتاح، قيمة) عشوائيًا من القاموس.