Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / PHP

preg_replace_callback()

Wywołuje funkcję dla każdego dopasowania i używa dosłownie zwróconego przez nią napisu.

Wersja: PHP 8.4; repository runtime, production runtime not attested

Składnia

preg_replace_callback(string|array $pattern, callable $callback, string|array $subject, int $limit = -1, int &$count = null, int $flags = 0): string|array|null

Wywołuje funkcję dla każdego dopasowania i używa dosłownie zwróconego przez nią napisu. Pod indeksem zero jest całe dopasowanie, dalej zawartość grup. Parametr count podaje liczbę zamian we wszystkich napisach. Przy błędzie kompilacji wzorca dla napisu wynikiem jest null, a dla tablicy z jednym napisem pusta tablica. Wyjątek z callbacka jest propagowany.

Sygnatura

preg_replace_callback(string|array $pattern, callable $callback, string|array $subject, int $limit = -1, int &$count = null, int $flags = 0): string|array|null

Wynik przykładu

["$3 $10",2]
[null,[]]
RuntimeException

Przykłady

<?php
$result=preg_replace_callback("~#(\\d+)~",fn($m)=>"$".((int)$m[1]+1),"#2 #9",-1,$n);
echo json_encode([$result,$n]);
set_error_handler(fn($level)=>$level===E_WARNING); $a=preg_replace_callback("~[~",fn($m)=>"","x"); $b=preg_replace_callback("~[~",fn($m)=>"",["x"]); restore_error_handler(); echo "\n",json_encode([$a,$b]);
try {preg_replace_callback("~x~",fn($m)=>throw new RuntimeException(),"x");} catch (RuntimeException $e) { echo "\n",get_class($e); }

Wynik

["$3 $10",2]
[null,[]]
RuntimeException

Źródła