Funktionen preg_replace

Funktionen preg_replace søger i en streng efter matches med et regulært udtryk og erstatter dem med en angivet streng. Den tager det regulære udtryk som første parameter, erstatningsstrengen som anden parameter og kildestrengen som tredje parameter. Yderligere kan man angive en erstatningsgrænse og en variabel til at tælle erstatninger.

Syntaks

preg_replace(pattern, replacement, subject, [limit], [count]);

Eksempel

Lad os erstatte alle cifre i strengen med tegnet 'X':

<?php
	$str = 'a1b2c3';
	$res = preg_replace('/\d/', 'X', $str);
	echo $res;
?>

Resultat af kodeudførelse:

'aXbXcX'

Eksempel

Lad os kun erstatte de første 2 matches:

<?php
	$str = 'a1b2c3';
	$res = preg_replace('/\d/', 'X', $str, 2);
	echo $res;
?>

Resultat af kodeudførelse:

'aXbXc3'

Eksempel

Brug af backreferencer i erstatning:

<?php
	$str = 'Hello World';
	$res = preg_replace('/(\w+)\s(\w+)/', '$2, $1', $str);
	echo $res;
?>

Resultat af kodeudførelse:

'World, Hello'

Eksempel

Tælling af udførte erstatninger:

<?php
	$str = 'a1b2c3';
	$count = 0;
	$res = preg_replace('/\d/', 'X', $str, -1, $count);
	echo "Result: $res, Replacements: $count";
?>

Resultat af kodeudførelse:

'Result: aXbXcX, Replacements: 3'

Se også

funktionen preg_match,
som udfører søgning med et regulært udtryk
funktionen preg_split,
som deler en streng med et regulært udtryk