WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Ruft 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

Quellen