CKTIS / PHP
preg_replace_callback()
Appelle une fonction pour chaque correspondance et insère littéralement la chaîne renvoyée.
Version : PHP 8.4; repository runtime, production runtime not attested
Syntaxe
preg_replace_callback(string|array $pattern, callable $callback, string|array $subject, int $limit = -1, int &$count = null, int $flags = 0): string|array|nullAppelle une fonction pour chaque correspondance et insère littéralement la chaîne renvoyée. L’indice zéro contient toute la correspondance, les suivants les captures. count totalise les remplacements dans les chaînes. Une erreur de compilation du motif donne null pour une chaîne et un tableau vide pour un tableau d’une chaîne. Une exception du callback se propage.
Signature
preg_replace_callback(string|array $pattern, callable $callback, string|array $subject, int $limit = -1, int &$count = null, int $flags = 0): string|array|null
Sortie de l’exemple
["$3 $10",2]
[null,[]]
RuntimeException
Exemples
<?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); }
Résultat
["$3 $10",2] [null,[]] RuntimeException