WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

re.Pattern.search: Den ersten Treffer mit einem kompilierten Muster finden

Mit einem kompilierten regulären Ausdruck findest du den ersten Treffer in einer Zeichenkette oder in einem durch Indizes begrenzten Bereich.

Version: Python 3.12

Syntax

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

re.Pattern.search ist eine Methode des Objekts, das re.compile() zurückgibt. pattern.search(string) liefert ein re.Match-Objekt für die erste Stelle, an der das Muster passt, auch mitten in der Zeichenkette. pattern.match() prüft dagegen nur an der Startposition, und pattern.fullmatch() verlangt, dass der gesamte angegebene Bereich passt.

Der optionale Index pos legt den Suchbeginn fest und ist standardmäßig 0. endpos ist die exklusive Obergrenze und entspricht standardmäßig der Länge der Zeichenkette. In CPython 3.12 werden pos und endpos auf Werte zwischen 0 und der Länge der Zeichenkette begrenzt, jeweils einschließlich. Gilt nach dieser Begrenzung endpos < pos, gibt die Methode None zurück. Ein gesetztes pos ist nicht dasselbe wie ein Ausschnitt: Der Anker ^ behandelt pos nicht als neuen Anfang der Zeichenkette.

Prüfe match is not None, bevor du das Ergebnis ausliest. Auch ein Treffer der Länge null ist ein re.Match-Objekt. match.group(0) liefert den gesamten passenden Teil, und match.span() liefert das Indexpaar (Anfang, Ende) in der ursprünglichen Zeichenkette, wobei der Endindex ausgeschlossen ist.

Die Modulfunktion re.search(pattern, string, flags=0) erhält das Muster als Argument und hat weder pos noch endpos als Parameter. Die Methode nutzt das bereits im kompilierten Objekt gespeicherte Muster, das du wiederverwenden kannst. Flags als Argumente übergibst du an re.compile(), nicht an pattern.search().

Beispiele

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))

Ergebnis

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

Das Muster erfasst einen ASCII-Großbuchstaben gefolgt von zwei ASCII-Ziffern. Der erste Aufruf findet `A17`; mit `pos=8` wird es übersprungen und `B42` gefunden. Bei `endpos=12` liegt die letzte `2` außerhalb des Suchbereichs, daher lautet das Ergebnis `None`.

Zugehörige Lektionen

  • Python · Lektion 30 · Mittlere Stufe · Version: 3

Quellen