عرض مصدر Python/match/groupdict

<noinclude>{{DISPLAYTITLE:التابع <code>match.groupdict()‎</code> في بايثون}}</noinclude>

يعيد التابع [[Python/tuples|قاموسًا]] يحتوي على جميع المجموعات الفرعية المسمّاة في كائن التطابق، وتستخدم أسماء المجموعات الفرعية كمفاتيح في القاموس.

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

<syntaxhighlight lang="python3">
match.groupdict(default=None)
</syntaxhighlight>

== المعاملات ==

=== <code>default</code> ===

يستخدم هذا المعامل لتعيين قيمة افتراضية للمجموعات غير الموجودة في حالة التطابق، ويأخذ القيمة الافتراضية <code>None</code>.

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

يعيد التابع قاموسًا يحتوي جميع المجموعات الفرعية المسمّاة ضمن حالة التطابق، وتستخدم أسماء المجموعات الفرعية كمفاتيح في القاموس. 

== أمثلة ==

يبين المثال التالي النتائج المعادة من هذا التابع:

<syntaxhighlight lang="python3">
>>> m = re.match(r"(?P<first_name>\w+) (?P<last_name>\w+)", "Malcolm Reynolds")
>>> m.groupdict()
{'first_name': 'Malcolm', 'last_name': 'Reynolds'} 
</syntaxhighlight>

== انظر أيضًا ==

* التابع [[Python/match/group|<code>match.group()</code>‎]]: يعيد التابع مجموعة فرعية واحدة أو أكثر من المجموعات الموجودة في كائن التطابق.
* التابع [[Python/match/groups|<code>match.groups()</code>‎]]: يعيد التابع <nowiki/>[[Python/tuples|صفًّا]] يحتوي على جميع المجموعات الفرعية الموجودة في كائن التطابق.

== مصادر ==

* [https://docs.python.org/3/library/re.html#re.match.groupdict قسم match في صفحة Regular expression operations في توثيق بايثون الرسمي].

[[تصنيف:Python]]
[[تصنيف:Python Regular Expressions]]
[[تصنيف:Python Method]]