База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Python

re.Pattern.search: първо съвпадение с компилиран шаблон

Използвай компилиран регулярен израз, за да намериш първото съвпадение в низ или в диапазон, ограничен от начален и краен индекс.

Версия: Python 3.12

Синтаксис

pattern = re.compile(expression, flags=0)
pattern.search(string[, pos[, endpos]]) -> re.Match | None

re.Pattern.search е метод на обекта, върнат от re.compile(). Извикването pattern.search(string) връща обект re.Match за първата позиция, на която шаблонът съвпада, дори тя да е в средата на низа. За разлика от него pattern.match() проверява само от началната позиция, а pattern.fullmatch() изисква целият зададен диапазон да съвпадне.

Незадължителният индекс pos задава откъде започва търсенето и по подразбиране е 0. endpos е горната граница, която не се включва, и по подразбиране е равна на дължината на низа. В CPython 3.12 стойностите на pos и endpos се ограничават до интервала от 0 до дължината на низа включително. Ако след това ограничаване endpos < pos, методът връща None. Задаването на pos не е равносилно на изрязване на част от низа: котвата ^ не приема pos за ново начало на низа.

Провери match is not None, преди да прочетеш резултата. Съвпадение с нулева дължина също е обект re.Match. match.group(0) връща целия съвпадащ подниз, а match.span() връща двойката индекси (начало, край) в оригиналния низ, като крайният индекс не се включва.

Функцията на модула re.search(pattern, string, flags=0) приема шаблона като аргумент и няма параметри pos и endpos. Методът използва шаблона, вече съхранен в компилирания обект, който можеш да използваш многократно. Подавай флаговете като аргументи на re.compile(), а не на pattern.search().

Примери

import re

pattern = re.compile(r"[A-Z][0-9]{2}")
text = "IDs: A17, B42"

for match in (pattern.search(text), pattern.search(text, pos=8)):
    if match is not None:
        print(match.group(0), match.span())

print(pattern.search(text, pos=8, endpos=12))

Резултат

A17 (5, 8)
B42 (10, 13)
None

Шаблонът съвпада с една главна ASCII буква, последвана от две ASCII цифри. Първото извикване намира `A17`; при `pos=8` търсенето го пропуска и намира `B42`. При `endpos=12` последната цифра `2` е извън диапазона на търсене, затова резултатът е `None`.

Свързани уроци

  • Python · Урок 30 · Средно · Версия: 3

Източници