التابع match.groups()
في بايثون
يعيد التابع صفًّا يحتوي على جميع المجموعات الفرعية الموجودة في كائن التطابق.
البنية العامة
match.groups(default=None)
المعاملات
default
يستخدم هذا المعامل لتعيين قيمة افتراضية للمجموعات غير الموجودة في حالة التطابق، ويأخذ القيمة الافتراضية None
.
القيمة المعادة
يعيد التابع صفًّا يحتوي على جميع المجموعات الفرعية الموجودة في كائن التطابق، بدءًا من المجموعة رقم 1
وانتهاءً بعدد المجموعات الفرعية الموجودة في التعبير النمطي.
أمثلة
يبين المثال التالي النتائج المعادة من هذا التابع:
>>> m = re.match(r"(\d+)\.(\d+)", "24.1632")
>>> m.groups()
('24', '1632')
إن جعلنا النقطة العشرية وما بعدها اختياريًا فلن تشارك جميع المجموعات في حالة التطابق، وستأخذ القيمة الافتراضية None
إن لم تعين قيمة المعامل default
:
>>> m = re.match(r"(\d+)\.?(\d+)?", "24")
>>> m.groups() # None تأخذ المجموعة الثانية القيمة الافتراضية
('24', None)
>>> m.groups('0') # '0' تأخذ المجموعة الثانية الآن القيمة
('24', '0')
انظر أيضًا
- التابع
match.group()
: يعيد التابع مجموعة فرعية واحدة أو أكثر من المجموعات الموجودة في كائن التطابق. - التابع
match.groupdict()
: يعيد التابع قاموسًا يحتوي على جميع المجموعات الفرعية المسمّاة في كائن التطابق، وتستخدم أسماء المجموعات الفرعية كمفاتيح في القاموس.