PHP preg_replace() Funktion
Beispiel
Verwenden Sie einen regulären Ausdruck ohne Berücksichtigung der Groß-/Kleinschreibung, um Microsoft durch W3Schools in einer Zeichenfolge zu ersetzen:
<?php
$str = 'Visit Microsoft!';
$pattern = '/microsoft/i';
echo
preg_replace($pattern, 'W3Schools', $str);
?>
Definition und Verwendung
Die preg_replace()
Funktion gibt eine Zeichenfolge oder ein Array von Zeichenfolgen zurück, wobei alle Übereinstimmungen eines Musters oder einer Liste von Mustern, die in der Eingabe gefunden wurden, durch Teilzeichenfolgen ersetzt werden.
Es gibt drei verschiedene Möglichkeiten, diese Funktion zu verwenden:
1. Ein Muster und eine Ersatzzeichenfolge. Übereinstimmungen des Musters werden durch die Ersatzzeichenfolge ersetzt.
2. Ein Array von Mustern und eine Ersatzzeichenfolge. Übereinstimmungen mit einem der Muster werden durch die Ersatzzeichenfolge ersetzt.
3. Ein Array von Mustern und ein Array von Ersatzzeichenfolgen. Übereinstimmungen jedes Musters werden durch die Ersetzungszeichenfolge an der gleichen Position im Ersetzungsarray ersetzt. Wenn an dieser Position kein Element gefunden wird, wird die Übereinstimmung durch eine leere Zeichenfolge ersetzt.
Ersetzungsstrings können eine Rückwärtsreferenz in der Form \n oder $n enthalten, wobei n der Index einer Gruppe im Muster ist. In der zurückgegebenen Zeichenfolge werden Instanzen von \n und $n durch die Teilzeichenfolge ersetzt, die mit der Gruppe übereinstimmte, oder, wenn \0 oder $0 verwendet werden, durch den gesamten Ausdruck.
Hinweis: Für jede Eingabezeichenfolge wertet die Funktion die Muster in der angegebenen Reihenfolge aus. Das Ergebnis der Auswertung des ersten Musters in der Zeichenfolge wird als Eingabezeichenfolge für das zweite Muster verwendet und so weiter. Dies kann zu unerwartetem Verhalten führen.
Syntax
preg_replace(patterns, replacements, input, limit, count)
Parameterwerte
Parameter | Description |
---|---|
patterns | Required. Contains a regular expression or array of regular expressions |
replacements | Required. A replacement string or an array of replacement strings |
input | Required. The string or array of strings in which replacements are being performed |
limit | Optional. Defaults to -1, meaning unlimited. Sets a limit to how many replacements can be done in each string |
count | Optional. After the function has executed, this variable will contain a number indicating how many replacements were performed |
Technische Details
Rückgabewert: | Gibt eine Zeichenfolge oder ein Array von Zeichenfolgen zurück, die sich aus der Anwendung der Ersetzungen auf die Eingabezeichenfolge oder -zeichenfolgen ergeben |
---|---|
PHP-Version: | 4.0.5+ |
Änderungsprotokoll: | PHP 5.1.0 - Der count-Parameter wurde hinzugefügt |
❮ PHP-RegExp-Referenz