Funkcja preg_replace() PHP
Przykład
Użyj wyrażenia regularnego bez rozróżniania wielkości liter, aby zastąpić Microsoft W3Schools w ciągu:
<?php
$str = 'Visit Microsoft!';
$pattern = '/microsoft/i';
echo
preg_replace($pattern, 'W3Schools', $str);
?>
Definicja i użycie
Funkcja preg_replace()
zwraca ciąg lub tablicę ciągów, w których wszystkie dopasowania wzorca lub listy wzorców znalezione w danych wejściowych są zastępowane podciągami.
Istnieją trzy różne sposoby korzystania z tej funkcji:
1. Jeden wzór i łańcuch zastępczy. Dopasowania wzorca są zastępowane ciągiem zastępczym.
2. Tablica wzorców i łańcuch zastępczy. Dopasowania dowolnych wzorców są zastępowane ciągiem zastępczym.
3. Tablica wzorców i tablica łańcuchów zastępczych. Dopasowania każdego wzorca są zastępowane ciągiem zastępczym w tej samej pozycji w tablicy zamienników. Jeśli w tej pozycji nie zostanie znaleziony żaden element, dopasowanie jest zastępowane pustym ciągiem.
Łańcuchy zastępcze mogą zawierać odwołanie wsteczne w postaci \n lub $n, gdzie n jest indeksem grupy we wzorcu. W zwróconym ciągu wystąpienia \n i $n zostaną zastąpione podciągiem, który został dopasowany przez grupę lub, jeśli użyto \0 lub $0, przez całe wyrażenie.
Uwaga: Dla każdego ciągu wejściowego funkcja ocenia wzorce w kolejności, w jakiej zostały podane. Wynik oceny pierwszego wzorca w ciągu jest używany jako ciąg wejściowy dla drugiego wzorca i tak dalej. Może to prowadzić do nieoczekiwanego zachowania.
Składnia
preg_replace(patterns, replacements, input, limit, count)
Wartości parametrów
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 |
Szczegóły techniczne
Wartość zwrotu: | Zwraca ciąg lub tablicę ciągów powstałych w wyniku zastosowania zamienników do wejściowego ciągu lub ciągów |
---|---|
Wersja PHP: | 4.0.5+ |
Dziennik zmian: | PHP 5.1.0 - Dodano parametr licznika |
❮ Dokumentacja RegExp PHP