CKTIS / PHP
preg_replace_callback()
Ruft für jeden Treffer ein Callable auf und setzt dessen Ergebnisstring wörtlich ein.
Version: PHP 8.4; repository runtime, production runtime not attested
Syntax
preg_replace_callback(string|array $pattern, callable $callback, string|array $subject, int $limit = -1, int &$count = null, int $flags = 0): string|array|nullRuft für jeden Treffer ein Callable auf und setzt dessen Ergebnisstring wörtlich ein. Index null enthält den gesamten Treffer, weitere Indizes die Gruppen. count zählt die Ersetzungen über alle Eingabetexte. Ein Musterkompilierungsfehler liefert für eine Zeichenkette null und für ein Array mit einer Zeichenkette ein leeres Array. Eine Ausnahme aus dem Callback wird weitergereicht.
Signatur
preg_replace_callback(string|array $pattern, callable $callback, string|array $subject, int $limit = -1, int &$count = null, int $flags = 0): string|array|null
Ausgabe des Beispiels
["$3 $10",2]
[null,[]]
RuntimeException
Beispiele
<?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); }
Ergebnis
["$3 $10",2] [null,[]] RuntimeException