PHP Handbuch
Zurück |  | Nach vorne

# XCII. Reguläre Ausdrücke Funktionen (Perl-kompatibel)

# Einführung

Die Syntax für Suchmuster, die in diesen Funktionen verwendet werden, ist Perl sehr ähnlich. Der Ausdruck muss von Begrenzungszeichen, z.B. von Schrägstrichen (/), umgeben sein. Jedes Zeichen kann als Begrenzungszeichen verwendet werden, solange es kein alphanumerisches Zeichen oder der Backslash (\) ist. Falls das Begrenzungszeichen im Ausdruck selbst verwendet wird, muss es mit dem Backslash als Escape-Zeichen maskiert werden. Seit PHP 4.0.4 können Sie auch dem Perl-Stil entsprechend (), {}, [] und <> als Begrenzung für Suchmuster verwenden. Für eine ausführliche Erklärung siehe Suchmuster-Syntax.

An die Schlussbegrenzung können verschiedene Modifikatoren angehängt werden, die das Suchergebnis beeinflussen. Siehe Modifikatoren für Suchmuster.

Bei Verwendung der POSIX-erweiterten Reguläre Ausdrücke Funktionen unterstützt PHP auch reguläre Ausdrücke mit POSIX-erweiterter Syntax.

Warnung
Sie sollten sich über ein paar Einschränkungen von PCRE bewusst sein. Lesen Sie bitte http://www.pcre.org/pcre.txt für weitere Informationen.

# Anforderungen

Die Unterstützung Regulärer Ausdrücke wird von der PCRE-Bibliothek, einem Open Source Software-Paket, geschrieben von Philip Hazel und unter dem Copyright der University of Cambridge, England, zur Verfügung gestellt. Es ist erhältlich unter ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/.

# Installation

Ab PHP 4.2.0 sind diese Funktionen standardmäßig aktiviert. Sie können die pcre-Funktionen mit `--without-pcre-regex` deaktivieren. Falls Sie nicht die mitgelieferte Bibliothek benutzen, geben Sie mit `--with-pcre-regex=VERZEICHNIS` an, in welchem Verzeichnis die Include- und Bibliotheks-Dateien von PCRE liegen. Bei älteren PHP-Versionen müssen Sie diese mit `--with-pcre-regex[=VERZEICHNIS]` konfigurieren und übersetzen, um diese Funktionen benutzen zu können.

The windows version of `PHP` has built in support for this extension. You do not need to load any additional extension in order to use these functions.

# Laufzeit Konfiguration

Diese Erweiterung definiert keine Konfigurationseinstellungen in der `php.ini`.

# Resource Typen

Diese Erweiterung definiert keine Resource-Typen.

# Vordefinierte Konstanten

Folgende Konstanten werden von dieser Erweiterung definiert und stehen nur zur Verfügung, wenn die Erweiterung entweder statisch in PHP kompiliert oder dynamisch zur Laufzeit geladen wurde.

Tabelle 1. PREG-Konstanten

Konstante | Beschreibung
--- | ---
PREG_PATTERN_ORDER | Sortiert die Ergebnisse so, dass $matches[0] ein Array von Übereinstimmungen mit dem ganzen Suchmuster ist, $matches[1] ein Array von Zeichenketten, die mit dem ersten geklammerten Teil-Suchmuster übereinstimmen und so weiter. Dieses Flag wird nur bei preg_match_all() verwendet.
PREG_SET_ORDER | Sortiert die Ergebnisse so, dass $matches[0] ein Array des ersten Satzes von Übereinstimmungen ist, $matches[1] ein Array des zweiten Satzes von Übereinstimmungen und so weiter. Dieses Flag wird nur bei preg_match_all() verwendet.
PREG_OFFSET_CAPTURE | Siehe Beschreibung von `PREG_SPLIT_OFFSET_CAPTURE`. Dieses Flag steht seit `PHP` 4.3.0 zur Verfügung.
PREG_SPLIT_NO_EMPTY | Dieses Flag teilt der Funktion preg_split() mit, dass sie nur nicht-leere Teile zurückgeben soll.
PREG_SPLIT_DELIM_CAPTURE | Dieses Flag teilt der Funktion preg_split() mit, dass sie auch die eingeklammerten Ausdrücke des Trennsymbol-Musters zurückgeben soll. Dieses Flag steht seit `PHP` 4.0.5 zur Verfügung.
PREG_SPLIT_OFFSET_CAPTURE | Wenn dieses Flag gesetzt ist, wird für jede gefundene Übereinstimmung auch der dazugehörige Versatz zurückgegeben. Beachten Sie, dass dies die Rückgabewerte in einem Array dahingehend ändert, dass jedes Element ein Array ist, das aus der übereinstimmenden Zeichenkette als erstem und deren Stelle im durchsuchten Text als zweitem Element besteht. Dieses Flag steht seit `PHP` 4.3.0 zur Verfügung und wird nur bei preg_split() verwendet.

# Beispiele

Beispiel 1. Beispiele gültiger Suchmuster `/<\/\w+>/` `|(\d{3})-\d+|Sm` `/^(?i)php[34]/` `{^\s+(\s+)?$}`

Beispiel 2. Beispiele ungültiger Suchmuster `/href='(.*)'` - fehlender Begrenzer am Ende `/\w+\s*\w+/J` - ungültiger Modifikator 'J' `1-\d3-\d3-\d4|` - fehlender Begrenzer am Anfang

Zurück | Zum Anfang | Nach vorne
recode | Nach oben | Pattern Modifiers