match-pattern()

Kategorie: String-Funktionen

Prüft, ob ein Textwert einem angegebenen regulären Ausdruck entspricht. Gibt true zurück, wenn das Muster übereinstimmt, andernfalls false.

Syntax

match-pattern(a, b)

Parameter	Typ	Beschreibung
`a`	Text	Der zu prüfende Textwert.
`b`	Text	Ein Java-kompatibler regulärer Ausdruck, gegen den `a` abgeglichen wird.

true, wenn der reguläre Ausdruck b vollständig auf den Text a zutrifft, andernfalls false.

Text (`a`)	Muster (`b`)	Ergebnis	Erklärung
`ABCabc`	`^\w+$`	`true`	Der Text besteht ausschließlich aus Wortzeichen (Buchstaben, Ziffern, Unterstrich).
`ABCabc`	`^\d+$`	`false`	Der Text besteht nicht ausschließlich aus Ziffern.
`ABCabc`	`^[A-z]+$`	`true`	Der Text enthält nur Zeichen im ASCII-Bereich A–z (umfasst Groß- und Kleinbuchstaben).
`ABCabc`	`^[A-Z]+$`	`false`	Der Text enthält auch Kleinbuchstaben; ein Muster für ausschließlich Großbuchstaben passt daher nicht.
`order-12345`	`^order-\d+$`	`true`	Passt auf das Präfix `order-`, gefolgt von einer oder mehreren Ziffern.
`2025-06-10`	`^\d{4}-\d{2}-\d{2}$`	`true`	Passt auf ein Datum im Format JJJJ-MM-TT.
(leer)	`^$`	`true`	Eine leere Zeichenkette passt auf das Muster für „leer".

Datenvalidierung: Sicherstellen, dass eingehende Feldwerte einem erwarteten Format entsprechen (z. B. Datum, E-Mail, Artikelnummer), bevor sie weiterverarbeitet werden.
Bedingte Zuordnung: match-pattern() innerhalb einer Bedingung verwenden, um zu steuern, ob eine Mapping-Regel angewendet wird, z. B. ein Feld nur dann zuordnen, wenn sein Wert mit einem bestimmten Präfix beginnt.
Filterung: Datensätze überspringen oder weiterleiten, je nachdem, ob ein Feldwert einem definierten Muster entspricht.

Der reguläre Ausdruck folgt der Java-Regex-Syntax (siehe java.util.regex.Pattern).
Das Muster wird gegen den gesamten Text abgeglichen. Verwende .* am Anfang oder Ende, um eine Teilübereinstimmung zu erreichen (z. B. .*keyword.*).
Zum Testen von Ausdrücken eignen sich Werkzeuge wie regex101.com (Flavor “Java" auswählen).
Ab Release 26.2: Die Gültigkeit eines regulären Ausdrucks wird automatisch geprüft, wenn Sie Pathfinder zur Erklärung nutzen. Sie erhalten von Pathfinder Rückmeldung, ob der Ausdruck gültig ist oder Fehler enthält.