الفرق بين المراجعتين ل"Python/dict/get"
اذهب إلى التنقل
اذهب إلى البحث
ط (←القيمة المعادة) |
|||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الدالة <code>dict.get()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:الدالة <code>dict.get()</code> في بايثون}}</noinclude> | ||
| − | + | يعيد التابع القيمة المرتبطة بالمفتاح الذي يحدّده المستخدم. | |
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="python3"> | <syntaxhighlight lang="python3"> | ||
| − | + | dict.get(key[, default]) | |
</syntaxhighlight> | </syntaxhighlight> | ||
| سطر 13: | سطر 13: | ||
=== <code>default</code> === | === <code>default</code> === | ||
| − | معامل اختياري وقيمته الافتراضية هي <code>None</code>. يحدّد هذا المعامل القيمة التي | + | معامل اختياري وقيمته الافتراضية هي <code>None</code>. يحدّد هذا المعامل القيمة التي سيعيدها التابع في حال عدم العثور على المفتاح المطلوب. |
== القيمة المعادة == | == القيمة المعادة == | ||
| − | + | يعيد التابع قيمة المفتاح المطلوب، وإن لم يعثر عليه فإنّه يعيد القيمة المحدّدة في المعامل <code>default</code>، وإن لم يمتلك هذا المعامل أيّ قيمة فإنّ التابع يعيد القيمة <code>None</code>. | |
== أمثلة == | == أمثلة == | ||
| − | يبين المثال التالي النتائج المعادة من تطبيق | + | يبين المثال التالي النتائج المعادة من تطبيق التابع: |
<syntaxhighlight lang="python3"> | <syntaxhighlight lang="python3"> | ||
>>> employee = {'first-name': 'Ahmed', 'last-name': 'Jamil', 'age': 28} | >>> employee = {'first-name': 'Ahmed', 'last-name': 'Jamil', 'age': 28} | ||
| سطر 33: | سطر 33: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* [[Python/dict|القواميس في بايثون.]] | * [[Python/dict|القواميس في بايثون.]] | ||
| + | *التابع <code>[[Python/dict/keys|dict.keys()]]</code>: يعيد التابع عرضًا جديدًا يتضمّن جميع مفاتيح القاموس. | ||
| + | *التابع <code>[[Python/dict/values|dict.values()]]</code>: عرض قيم المفاتيح الخاصة بالقاموس. | ||
== مصادر == | == مصادر == | ||
* [https://docs.python.org/3/library/stdtypes.html#dict.get قسم get في صفحة Types في توثيق بايثون الرسمي.] | * [https://docs.python.org/3/library/stdtypes.html#dict.get قسم get في صفحة Types في توثيق بايثون الرسمي.] | ||
مراجعة 10:37، 10 يونيو 2018
يعيد التابع القيمة المرتبطة بالمفتاح الذي يحدّده المستخدم.
البنية العامة
dict.get(key[, default])
المعاملات
key
اسم المفتاح المراد إعادة قيمته.
default
معامل اختياري وقيمته الافتراضية هي None. يحدّد هذا المعامل القيمة التي سيعيدها التابع في حال عدم العثور على المفتاح المطلوب.
القيمة المعادة
يعيد التابع قيمة المفتاح المطلوب، وإن لم يعثر عليه فإنّه يعيد القيمة المحدّدة في المعامل default، وإن لم يمتلك هذا المعامل أيّ قيمة فإنّ التابع يعيد القيمة None.
أمثلة
يبين المثال التالي النتائج المعادة من تطبيق التابع:
>>> employee = {'first-name': 'Ahmed', 'last-name': 'Jamil', 'age': 28}
>>> print(employee.get('first-name'))
Ahmed
>>> print(employee.get('height'))
None
>>> print(employee.get('height', '175 cm'))
175 cm
انظر أيضًا
- القواميس في بايثون.
- التابع
dict.keys(): يعيد التابع عرضًا جديدًا يتضمّن جميع مفاتيح القاموس.
- التابع
dict.values(): عرض قيم المفاتيح الخاصة بالقاموس.