التابع match.groups()‎ في بايثون

من موسوعة حسوب
< Python‏ | match

يعيد التابع صفًّا يحتوي على جميع المجموعات الفرعية الموجودة في كائن التطابق.

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

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

مصادر