CKTIS / Python
re.Pattern.fullmatch: de volledige tekenreeks controleren
Met deze methode van een gecompileerde reguliere expressie controleer je of het patroon past op de hele tekenreeks of op het volledige bereik tussen `pos` en `endpos`.
Versie: Python 3.12
Syntax
compiled.fullmatch(string[, pos[, endpos]]) -> re.Match | Nonere.Pattern.fullmatch is een methode van het object dat re.compile() teruggeeft. Zonder opgegeven grenzen moet het patroon op de hele tekenreeks passen. Bij een overeenkomst geeft de methode een re.Match-object terug, anders None. Een overeenkomst met lengte nul telt ook; controleer met result is not None of er een overeenkomst is.
De optionele index pos bepaalt het begin (standaard 0) en endpos bepaalt het eindpunt, dat niet bij het bereik hoort (standaard len(string)). De overeenkomst moet het hele bereik beslaan. In CPython 3.12 worden beide indices begrensd tot het interval van 0 tot en met len(string). Als endpos na die begrenzing kleiner is dan pos, is er geen overeenkomst. Zijn de resulterende waarden gelijk, dan is een overeenkomst met lengte nul mogelijk. span() geeft indices in de oorspronkelijke tekenreeks terug. Grenzen instellen is niet hetzelfde als een deelreeks maken: ^ behandelt pos bijvoorbeeld niet als een nieuw begin van de tekenreeks.
Gebruik Pattern.match() als een overeenkomst aan het begin van het bereik volstaat, of Pattern.search() om ergens in het bereik een overeenkomst te vinden. De modulefunctie re.fullmatch(pattern, string, flags=0) krijgt het patroon als argument, maar biedt geen pos of endpos. De methode gebruikt het al gecompileerde patroon en de bijbehorende vlaggen; ze neemt geen flags-argument aan.
Voorbeelden
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())Resultaat
True False (1, 6)
Het patroon vereist twee ASCII-hoofdletters, een koppelteken en twee ASCII-cijfers. `AB-42` past, maar `AB-42!` niet. In `[AB-42]` vallen beide vierkante haken buiten het bereik van `1` inclusief tot `6` exclusief. Daarom geeft `span()` `(1, 6)` terug.
Gerelateerde lessen
- Python · Les 29 · Gemiddeld · Versie: 3