Funkcja PHP preg_replace_callback() przeszukuje łańcuch znaków PHP przy użyciu wyrażenia regularnego i zamienia fragmenty tekstu pasujące do wzorca za pomocą funkcji zwrotnej PHP.
Składnia funkcji PHP preg_replace_callback()
Funkcja PHP preg_replace_callback() ma następującą składnię:
preg_replace_callback(
string|array $pattern,
callable $callback,
string|array $subject,
int $limit = -1,
int &$count = null,
int $flags = 0
): string|array|nullParametry
| pattern | Parametr obowiązkowy. Wzorzec lub tablica wzorców w postaci łańcuchów, które mają zostać znalezione. |
| callback | Parametr obowiązkowy. Funkcja zwrotna PHP, której zostanie przekazana tablica elementów będących dopasowanymi do wzorca łańcuchami z łańcucha subject. Sygnatura tej funkcji:
Jako funkcji zwrotnej można użyć wbudowanej funkcji PHP, samodzielnie zdefiniowanej funkcji, funkcji anonimowej PHP lub funkcji strzałkowej PHP. |
| 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_callback() zwraca również tablicę. |
| limit | Maksymalna liczba zamian. Domyślna jest wartość -1, która oznacza brak ograniczenia. |
| count | Zmienna, której wartością będzie liczba wykonanych zamian. |
| flags | Stałe PHP modyfikujące sposób działania funkcji. Dostępne są następujące flagi:
|
Wartość zwrotna
Funkcja PHP preg_replace_callback() zwraca tablicę, jeśli parametr subject, jest tablicą, lub łańcuch w przeciwnym przypadku. W razie wystąpienia błędu funkcja ta zwraca null.
