التابع 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()‎ : يعيد التابع قاموسًا يحتوي على جميع المجموعات الفرعية المسمّاة في كائن التطابق، وتستخدم أسماء المجموعات الفرعية كمفاتيح في القاموس.

مصادر

• قسم match في صفحة Regular expression operations في توثيق بايثون الرسمي.