Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / PHP

preg_replace_callback()

Invoca una funzione per corrispondenza e inserisce letteralmente la stringa restituita.

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

Sintassi

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

Invoca una funzione per corrispondenza e inserisce letteralmente la stringa restituita. L’indice zero contiene l’intera corrispondenza e i successivi le catture. count conta tutte le sostituzioni nelle stringhe. Un errore di compilazione del motivo dà null per una stringa e un array vuoto per un array di una stringa. Un’eccezione del callback si propaga.

Firma

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

Output dell’esempio

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

Esempi

<?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); }

Risultato

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

Fonti