PHP preg_match_all() Funktion
Beispiel
Finden Sie alle Vorkommen von "ain" in einer Zeichenfolge:
<?php
$str = "The rain in SPAIN falls mainly on the plains.";
$pattern =
"/ain/i";
if(preg_match_all($pattern, $str, $matches)) {
print_r($matches);
}
?>
Definition und Verwendung
Die preg_match_all()
Funktion gibt die Anzahl der Übereinstimmungen eines Musters zurück, die in einer Zeichenfolge gefunden wurden, und füllt eine Variable mit den gefundenen Übereinstimmungen.
Syntax
preg_match_all(pattern, input, matches, flags, offset)
Parameterwerte
Parameter | Description |
---|---|
pattern | Required. Contains a regular expression indicating what to search for |
input | Required. The string in which the search will be performed |
matches | Optional. The variable used in this parameter will be populated with an array containing all of the matches that were found |
flags | Optional. A set of options that change how the matches array is structured. One of the following structures may be selected:
|
offset | Optional. Defaults to 0. Indicates how far into the string to begin searching. The preg_match() function will not find matches that occur before the position given in this parameter |
Technische Details
Rückgabewert: | Gibt die Anzahl der gefundenen Übereinstimmungen oder falsch zurück, wenn ein Fehler aufgetreten ist |
---|---|
PHP-Version: | 4+ |
Änderungsprotokoll: | PHP 7.2 – Flag PREG_UNMATCHED_AS_NULL hinzugefügt. PHP 5.4 – Der Parameter „Matches“ wurde optional . PHP 5.3.6 – Die Funktion gibt „false“ zurück, wenn der Offset länger als die Länge der Eingabe ist. ) und (? <name>) Syntax zusätzlich zur vorherigen (?P<name>) Syntax |
Mehr Beispiele
Beispiel
Verwenden Sie PREG_PATTERN_ORDER, um die Struktur des Match -Arrays festzulegen. In diesem Beispiel enthält jedes Element im matchs -Array alle Übereinstimmungen für eine der Gruppierungen des regulären Ausdrucks.
<?php
$str = "abc ABC";
$pattern = "/((a)b)(c)/i";
if(preg_match_all($pattern,
$str, $matches, PREG_PATTERN_ORDER)) {
print_r($matches);
}
?>
❮ PHP-RegExp-Referenz