PHP-Funktion preg_match()

PHP Reguläre Ausdrücke (PCRE)

Die Funktion preg_match wird verwendet, um einen regulären Ausdruck abzugleichen.

Syntax

int preg_match ( string $pattern , string $subject [, array &$matches [, int $flags = 0 [, int $offset = 0 ]]] )

Durchsucht subject nach einer Übereinstimmung mit dem durch pattern angegebenen regulären Ausdruck.

Parameter description:

  • $pattern: Das Suchmuster als String.

  • $subject: Die Eingabezeichenfolge.

  • $matches: Wenn der Parameter matches angegeben wird, wird er mit den Suchergebnissen gefüllt. $matches

  • $flags: Flags können auf die folgenden Flag-Werte gesetzt werden:

    1. PREG_OFFSET_CAPTURE: Wenn dieses Flag übergeben wird, wird für jedes Vorkommen einer Übereinstimmung der String-Offset (relativ zum Zielstring) angehängt. Hinweis: Dadurch ändert sich das in den Parameter matches gefüllte Array, sodass jedes Element ein Array ist, bei dem das 0. Element der übereinstimmende String und das 1. Element der Offset dieses übereinstimmenden Strings im Zielstring subject ist.

  • offset: Normalerweise beginnt die Suche am Anfang des Zielstrings. Der optionale Parameter offset wird verwendet, um anzugeben, dass die Suche an einer bestimmten Position im Zielstring (in Bytes) begonnen werden soll.

Rückgabewert

Gibt die Anzahl der Übereinstimmungen für pattern zurück. Ihr Wert wird 0 (keine Übereinstimmung) oder 1 sein, da preg_match() die Suche nach der ersten Übereinstimmung beendet. preg_match_all() ist anders; es durchsucht subject weiter, bis das Ende erreicht ist. Wenn ein Fehler auftritt, gibt preg_match() FALSE zurück.

Beispiele

Finde die Textzeichenfolge "php":

<?php //Das 'i' nach dem Musterbegrenzer kennzeichnet eine Suche ohne Beachtung der Groß-/Kleinschreibung. if (preg_match("/php/i", "PHP ist die Web-Skriptsprache der Wahl.")) { echo "Die übereinstimmende Zeichenfolge php wurde gefunden."; } else { echo "Die übereinstimmende Zeichenfolge php wurde nicht gefunden."; } ?>

Das Ausführungsergebnis ist wie folgt:

查找到匹配的字符串 php。


Finde das Wort "web"

<?php /*Das \b im Muster markiert eine Wortgrenze, sodass nur das alleinstehende Wort "web" gefunden wird und nicht * Teile eines Wortes wie "webbing" oder "cobweb"*/ if (preg_match("/\bweb\b/i", "PHP ist die Web-Skriptsprache der Wahl.")) { echo "Eine übereinstimmende Zeichenfolge wurde gefunden.\n"; } else { echo "Es wurde keine übereinstimmende Zeichenfolge gefunden.\n"; } if (preg_match("/\bweb\b/i", "PHP ist die Webseiten-Skriptsprache der Wahl.")) { echo "Eine übereinstimmende Zeichenfolge wurde gefunden.\n"; } else { echo "Es wurde keine übereinstimmende Zeichenfolge gefunden.\n"; } ?>

Das Ausführungsergebnis ist wie folgt:

Matching string found.


Domainnamen aus der URL abrufen

<?php //Hostnamen aus der URL abrufen preg_match('@^(?:http://)?([^/]+)@i', "http://www.example.com/index.html", $matches); $host = $matches[1]; //Die letzten beiden Teile des Hostnamens abrufen preg_match('/[^.]+\.[^.]+$/', $host, $matches); echo "Domainname ist: {$matches[0]}\n"; ?>

Das Ausführungsergebnis ist wie folgt:

domain name is: example.com


Verwendung benannter Untergruppen

<?php $str = 'foobar: 2008'; preg_match('/(?P<name>\w+): (?P<digit>\d+)/', $str, $matches); /*Das folgende Beispiel funktioniert unter PHP 5.2.2 (PCRE 7.0) oder später; allerdings ist aus Gründen der Abwärtskompatibilität die obige Vorgehensweise die empfohlene Syntax.*/ // preg_match('/(?<name>\w+): (?<digit>\d+)/', $str, $matches); print_r($matches); ?>

Das Ausführungsergebnis ist wie folgt:

Array
(
    [0] => foobar: 2008
    [name] => foobar
    [1] => foobar
    [digit] => 2008
    [2] => 2008
)

PHP Reguläre Ausdrücke (PCRE)

Andere Erweiterungen