Funktion str_replace

Die Funktion str_replace sucht in einer Zeichenkette nach einem bestimmten Text und ersetzt ihn durch einen anderen. Der erste Parameter der Funktion akzeptiert das, was ersetzt werden soll, und der zweite - wodurch es ersetzt werden soll. Dies können zwei Zeichenketten oder zwei Arrays sein. Im zweiten Fall werden die entsprechenden Elemente des einen Arrays durch die entsprechenden Elemente des zweiten Arrays ersetzt (siehe Beispiele).

Syntax

str_replace(array|string $search, array|string $replace, string|array $subject, int &$count = null): string|array

Beispiel

Ersetzen wir alle Buchstaben 'a' durch '!':

<?php
	echo str_replace('a', '!', 'abcabc');
?>

Ergebnis der Codeausführung:

'!bc!bc'

Beispiel

Ersetzen wir alle Buchstaben 'a' durch 1, Buchstaben 'b' durch 2, Buchstaben 'c' durch 3:

<?php
	echo str_replace(['a', 'b', 'c'], [1, 2, 3], 'abcabc');
?>

Ergebnis der Codeausführung:

'123123'

Beispiel

Ersetzen wir die angegebenen Buchstaben durch ein gemeinsames festgelegtes Zeichen:

<?php
	echo str_replace(['a', 'b', 'c'], '!', 'abcabc');
?>

Ergebnis der Codeausführung:

'!!!!!!'

Beispiel

Führen wir den Ersatz in jedem Element des Arrays durch:

<?php
	$arr = ['abc', 'abc', 'abc'];
	$res = str_replace('a', '!', $arr);
	print_r($res);
?>

Ergebnis der Codeausführung:

['!bc', '!bc', '!bc']

Beispiel

Groß-/Kleinschreibung ist relevant:

<?php
	echo str_replace('a', '!', 'Abcabc');
?>

Ergebnis der Codeausführung:

'Abc!bc'

Siehe auch

die Funktion str_ireplace,
die eine Suche und Ersetzung ohne Berücksichtigung der Groß-/Kleinschreibung durchführt
die Funktion strtr,
die ebenfalls eine Suche und Ersetzung durchführt
die Funktion substr_replace,
die einen Teil einer Zeichenkette ausschneidet und durch einen anderen ersetzt