Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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|null

Appelle 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

Sources