Funkcja PHP preg_replace() wyszukuje i zamienia fragmenty tekstu w łańcuchu znaków PHP na podstawie wyrażenia regularnego.
Składnia funkcji PHP preg_replace()
Funkcja PHP preg_replace() ma następującą składnię:
preg_replace(
string|array $pattern,
string|array $replacement,
string|array $subject,
int $limit = -1,
int &$count = null
): string|array|nullParametry
| Parametr | Opis |
|---|---|
| pattern | Parametr obowiązkowy. Wzorzec lub tablica wzorców które mają zostać znalezione. |
| replacement | Parametr obowiązkowy. Łańcuch lub tablica łańcuchów na wymianę.
Jeśli parametr ten jest łańcuchem, a parametr pattern jest tablicą, to wszystkie dopasowania zostaną zamienione na ten łańcuch. Jeśli parametr ten jest tablicą łańcuchów a parametr pattern jest tablicą wzorców, to dopasowania wzorców będą zastępowane przez elementy tablicy replacement odpowiadające elementom tablicy pattern. Ponadto parametr replacement może mieć wartość w postaci $n (ewentualnie Skąd ten wynik? Całe wyrażenie regularne W efekcie mamy literę o wstawioną za ciąg znaków kot, a po niej mamy literę a, która jest po prostu dalszą częścią łańcucha. |
| subject | Parametr obowiązkowy. Łańcuch lub tablica łańcuchów do przeszukania w celu ewentualnej zamiany ciągów. Jeśli jest to tablica PHP, to funkcja preg_replace() zwraca również tablicę. |
| limit | Maksymalna liczba zamian. Domyślna jest wartość -1, oznaczająca brak ograniczenia. |
| count | Zmienna, której wartością będzie liczba wykonanych zamian. |
Wartość zwrotna
Jeśli cokolwiek zostanie znalezione i zamienione, funkcja PHP preg_replace() zwraca zmodyfikowaną tablicę subject, jeśli jest ona tablicą, lub zwraca zmodyfikowany łańcuch subject, jeśli jest on łańcuchem.
Jeśli nic nie zostanie znalezione, funkcja preg_replace() zwraca subject bez zmian.
W przypadku wystąpienia błędu, zostaje zwrócona wartość null.
