На этом шаге мы рассмотрим объект Match.

    Объект Match, возвращаемый методами (функциями) match() и search(), имеет следующие свойства и методы:

• re - ссылка на скомпилированный шаблон, указанный в методах (функциях) match() и search(). Через эту ссылку доступны следующие свойства:
  • groups - количество групп в шаблоне;
  • groupindex - словарь с названиями групп и их номерами;
  • pattern - исходная строка с регулярным выражением;
  • flags - комбинация флагов, заданных при создании регулярного выражения в функции compile(), и флагов, указанных в самом регулярном выражении, в конструкции (?aiLmsux);

• string - значение параметра <Строка> в методах (функциях) match() и search();

• pos - значение параметра <Начальная позиция> в методах match() и search();

• endpos - значение параметра <Конечная позиция> в методах match() и search();

• lastindex - возвращает номер последней группы или значение None, если поиск завершился неудачей;

• lastgroup - возвращает название последней группы или значение None, если эта группа не имеет имени, или поиск завершился неудачей. Пример:

  >>> import re
  >>> p = re.compile(r'(?P<num>[0-9]+)(?P<str>[a-z]+)')
  >>> m = p.search('123456string 67890text')
  >>> m
  <re.Match object; span=(0, 12), match='123456string'>
  >>> m.re.groups, p.groupindex
  (2, mappingproxy({'num': 1, 'str': 2}))
  >>> m.string
  '123456string 67890text'
  >>> m.lastindex, m.lastgroup
  (2, 'str')
  >>> m.pos, m.endpos
  (0, 22)
  

• group ([<id1 или name1> [, ..., <idN или nameN>] ]) - возвращает фрагменты, соответствующие шаблону. Если параметр не задан или указано значение 0, возвращается фрагмент, полностью соответствующий шаблону. Если указан номер или название группы, возвращается фрагмент, совпадающий с этой группой. Через запятую можно указать несколько номеров или названий групп - в этом случае возвращается кортеж, содержащий фрагменты, что соответствует группам. Если нет группы с указанным номером или названием, то возбуждается исключение IndexError. Примеры:

  >>> p = re.compile(r'(?P<num>[0-9]+)(?P<str>[a-z]+)')
  >>> m = p.search('123456string 67890text')
  >>> m.group(), m.group(0) #  Полное соответствие шаблону
  ('123456string', '123456string')
  >>> m.group(1), m.group(2) # Ображение по индексу
  ('123456', 'string')
  >>> m.group('num'), m.group('str') # Ображение по названию
  ('123456', 'string')
  >>> m.group(1, 2), m.group('num', 'str') # Несколько параметров
  'num'(('123456', 'string'), ('123456', 'string'))
  

• groupdict (<Значение по умолчанию>]) - возвращает словарь, содержащий значения именованных групп. С помощью необязательного параметра можно указать значение, которое будет выводиться вместо значения None для групп, не имеющих совпадений:

  >>> p = re.compile(r'(?P<num>[0-9]+)(?P<str>[a-z]+)?')
  >>> m = p.search('123456')
  >>> m.groupdict()
  {'num': '123456', 'str': None}
  >>> m.groupdict('')
  {'num': '123456', 'str': ''}
  

• groups (<Значение по умолчанию>]) - возвращает кортеж, содержащий значения всех групп. С помощью необязательного параметра можно указать значение, которое будет выводиться вместо значения None для групп, не имеющих совпадений:

  >>> p = re.compile(r'(?P<num>[0-9]+)(?P<str>[a-z]+)?')
  >>> m = p.search('123456')
  >>> m.groups()
  ('123456', None)
  >>> m.groups('')
  ('123456', '')
  

• start ([<Номер или название группы>]) - возвращает индекс начала фрагмента, соответствующего заданной группе. Если параметр не указан, то фрагментом является полное соответствие с шаблоном. Если соответствия нет, то возвращается значение -1;

• end ([<Номер или название группы>]) - возвращает индекс конца фрагмента, соответствующего заданной группе. Если параметр не указан, то фрагментом является полное соответствие с шаблоном. Если соответствия нет, то возвращается значение -1;

• span ([<Номер или название группы>]) - возвращает кортеж, содержащий начальный и конечный индексы фрагмента, соответствующего заданной группе. Если параметр не указан, то фрагментом является полное соответствие с шаблоном. Если соответствия нет, то возвращается значение (-1, -1). Примеры:

  >>> p = re.compile(r'(?P<num>[0-9]+)(?P<str>[a-z]+)')
  >>> s = 'str123456str'
  >>> m = p.search(s)
  >>> m.start(), m.end(), m.span()
  (3, 12, (3, 12))
  >>> m.start(1), m.end(1), m.start('num'), m.end('num')
  (3, 9, 3, 9)
  >>> m.start(2), m.end(2), m.start('str'), m.end('str')
  (9, 12, 9, 12)
  >>> m.span(1), m.span('num'), m.span(2), m.span('str')
  ((3, 9), (3, 9), (9, 12), (9, 12))
  >>> s[m.start(1):m.end(1)], s[m.start(2):m.end(2)]
  ('123456', 'str')
  

• expand (<Шаблон>) - производит замену в строке. Внутри указанного шаблона можно использовать обратные ссылки: \номер группы, \g<номер группы> и \g<название группы>. Для примера поменяем два тега местами:

  >>> p = re.compile(r'<(?P<tag1>[a-z]+)><(?P<tag2>[a-z]+)>')
  >>> m = p.search('<br><hr>')
  >>> m.expand(r'<\2><\1>') #  \номер
  '<hr><br>'
  >>> m.expand(r'<\g<2>><\g<1>>') #  \g<номер>
  '<hr><br>'
  >>> m.expand(r'<\g<tag2>><\g<tag1>>') #  \g<название>
  '<hr><br>'
  

    В качестве примера использования метода search() проверим на соответствие шаблону введенный пользователем адрес электронной почты:

# -*- coding: utf-8 -*-
import re
email = input("Введите e-mail: ")
pe = r"^([a-z0-9_.-]+)@(([a-z0-9-]+\.)+[a-z]{2,6})$"
p = re.compile(pe, re.I | re.S)
m = p.search(email)
if not m:
    print("E-mail не соответствует шаблону")
else:
    print("E-mail", m.group(0), "соответствует шаблону")
    print("ящик:", m.group(1), "домен:", m.group(2))
input()

    Результат работы приложения изображен на рисунке 1:

Рис.1. Результат работы приложения

    На следующем шаге мы рассмотрим поиск всех совпадений с шаблоном.

Предыдущий шаг Содержание Следующий шаг