все Python 3reфункция

re.Match.groupdict()

группы

Возвращает словарь ИМЕНОВАННЫХ групп объекта Match — тех, что заданы через (?P<имя>...). Безымянные группы в словарь не попадают.

Синтаксис

m.groupdict(default=None)

Имена переживают правки, которые ломают номера: вставили группу в середину длинного паттерна — все индексы съехали, а ключи словаря остались прежними. Если именованных групп в паттерне нет, вернётся пустой словарь, а не None и не ошибка; необязательная именованная группа, которая не сработала, всё равно попадёт в словарь — со значением default. Имена обязаны быть валидными идентификаторами и уникальными внутри паттерна, иначе он не скомпилируется.

Примеры

import re
m = re.match(r'(?P<y>\d{4})-(?P<m>\d{2})', '2024-01')
m.groupdict() # → {'y': '2024', 'm': '01'}
m.group('y') # → '2024' (по имени)

См. также

Частые ошибки

Открыть в полном глоссарииdocs.python.orgСообщить о неточности