PHP preg_match_all() Funktion

PHP 正则表达式(PCRE)PHP Reguläre Ausdrücke (PCRE)

Die Funktion preg_match_all wird verwendet, um einen globalen Abgleich mit einem regulären Ausdruck durchzuführen.

Syntax

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

Durchsucht subject nach allen Übereinstimmungen mit dem durch pattern angegebenen regulären Ausdruck und gibt sie in der durch flags angegebenen Reihenfolge an matches aus.

Nachdem die erste Übereinstimmung gefunden wurde, werden nachfolgende Suchen von der Position der letzten Übereinstimmung fortgesetzt.

Parameter description:

  • $pattern: Das Suchmuster als String.

  • $subject: Die Eingabezeichenfolge.

  • $matches: Ein mehrdimensionales Array, das alle übereinstimmenden Ergebnisse als Ausgabeparameter ausgibt. Die Reihenfolge des Arrays wird durch flags festgelegt.

  • $flags: Kann mit den folgenden Flags verwendet werden (beachten Sie, dass PREG_PATTERN_ORDER und PREG_SET_ORDER nicht gleichzeitig verwendet werden können):

    1. PREG_PATTERN_ORDER: Ergebnisse werden so geordnet, dass $matches

    2. PREG_SET_ORDER: Ergebnisse werden so geordnet, dass $matches

    3. PREG_OFFSET_CAPTURE: Wenn dieses Flag übergeben wird, enthält jede gefundene Übereinstimmung bei der Rückgabe auch ihren Offset relativ zur Zielzeichenkette.

  • offset: Normalerweise beginnt die Suche am Anfang der Zielzeichenkette. Der optionale Parameter offset wird verwendet, um die Suche an einer angegebenen Position in der Zielzeichenkette (in Bytes) zu starten.

Rückgabewert

Gibt die Anzahl der vollständigen Übereinstimmungen zurück (die 0 sein kann) oder FALSE, wenn ein Fehler auftritt.

Beispiele

Sucht nach Inhalt, der zu den Tags <b> und </b> passt:

<?php $userinfo = "Name: <b>PHP</b> <br> Titel: <b>Programmiersprache</b>"; preg_match_all ("/<b>(.*)<\/b>/U", $userinfo, $pat_array); print_r($pat_array[0]); ?>

Das Ausführungsergebnis ist wie folgt:

Array
(
    [0] => <b>PHP</b>
    [1] => <b>Programming Language</b>
)

Passende HTML-Tags finden (greedy):

<?php //\\2 ist ein Beispiel für eine Rückreferenz. Dies teilt PCRE mit, dass es mit dem Ergebnis übereinstimmen muss, das von der zweiten geklammerten Gruppe im regulären Ausdruck erfasst wurde (hier, ([\w]+)) //Das übereinstimmende Ergebnis. Zwei Backslashes werden hier verwendet, weil doppelte Anführungszeichen verwendet werden. $html = "<b>bold text</b><a href=howdy.html>click me</a>"; preg_match_all("/(<([\w]+)[^>]*>)(.*?)(<\/\\2>)/", $html, $matches, PREG_SET_ORDER); foreach ($matches as $val) { echo "Treffer: " . $val[0] . "\n"; echo "Teil 1: " . $val[1] . "\n"; echo "Teil 2: " . $val[2] . "\n"; echo "Teil 3: " . $val[3] . "\n"; echo "Teil 4: " . $val[4] . "\n\n"; } ?>

Das Ausführungsergebnis ist wie folgt:

matched: <b>bold text</b>
part 1: <b>
part 2: b
part 3: bold text
part 4: </b>

matched: <a href=howdy.html>click me</a>
part 1: <a href=howdy.html>
part 2: a
part 3: click me
part 4: </a>

PHP 正则表达式(PCRE)PHP Reguläre Ausdrücke (PCRE)

Andere Erweiterungen