KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / PHP

preg_replace_callback()

Roept per overeenkomst een functie aan en voegt de geretourneerde tekenreeks letterlijk in.

Versie: 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

Roept per overeenkomst een functie aan en voegt de geretourneerde tekenreeks letterlijk in. Index nul bevat de hele overeenkomst en verdere indices de groepen. count telt alle vervangingen in de invoerteksten. Een compileerfout in het patroon geeft null bij een tekenreeks en een lege array bij een array met één tekenreeks. Een uitzondering uit de callback wordt doorgegeven.

Signatuur

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

Uitvoer van het voorbeeld

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

Voorbeelden

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

Resultaat

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

Bronnen