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

CKTIS / Python

re.Pattern.fullmatch: съвпадение с целия низ

Този метод на компилиран регулярен израз проверява дали шаблонът съвпада с целия низ или с целия диапазон, определен от индексите `pos` и `endpos`.

Версия: Python 3.12

Синтаксис

compiled.fullmatch(string[, pos[, endpos]]) -> re.Match | None

re.Pattern.fullmatch е метод на обекта, който re.compile() връща. Ако не са зададени граници, шаблонът трябва да обхване целия низ. При съвпадение методът връща обект re.Match, а иначе — None. Съвпадение с нулева дължина също е съвпадение; използвай result is not None, за да провериш дали има такова.

Незадължителният индекс pos задава началото (по подразбиране 0), а endpos задава края, който не е включен в диапазона (по подразбиране len(string)). Съвпадението трябва да обхване целия диапазон. В CPython 3.12 стойностите и на двата индекса се ограничават до интервала от 0 до len(string) включително. Ако след това ограничаване endpos е по-малък от pos, няма съвпадение. Ако получените стойности са равни, е възможно съвпадение с нулева дължина. span() връща индексите в оригиналния низ. Задаването на граници не е равнозначно на извличане на подниз: например ^ не приема pos за ново начало на низа.

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

Примери

import re

code_pattern = re.compile(r"[A-Z]{2}-[0-9]{2}")

print(code_pattern.fullmatch("AB-42") is not None)
print(code_pattern.fullmatch("AB-42!") is not None)

match = code_pattern.fullmatch("[AB-42]", 1, 6)
assert match is not None
print(match.span())

Резултат

True
False
(1, 6)

Шаблонът изисква две главни ASCII букви, дефис и две ASCII цифри. `AB-42` съвпада, но `AB-42!` не съвпада. В `[AB-42]` диапазонът от `1` включително до `6` изключително оставя и двете квадратни скоби извън съвпадението, затова `span()` връща `(1, 6)`.

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

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

Източници