substr_replaceErsetzt Text innerhalb einer Zeichenkette
&reftitle.description;
stringarraysubstr_replacearraystringstringarraystringreplacearrayintoffsetarrayintnulllength&null;substr_replace ersetzt in einer Kopie von
string alle Zeichen, die sich innerhalb der durch
die Parameter offset und (optional)
length festgelegten Grenze befinden, mit der in
replace angegebenen Zeichenkette.
&reftitle.parameters;
string
Die Eingabezeichenkette.
Ein array von strings kann übergeben werden;
die Ersetzungen erfolgen dann bei jeder Zeichenkette der Reihe nach. In
diesem Fall können die Parameter replace,
offset und length
entweder als Skalar übergeben werden, die auf jede Eingabezeichenkette
der Reihe nach angewandt werden, oder als arrays; in
diesem Fall wird das entsprechende Array-Element für jede
Eingabezeichenkette genutzt.
replace
Die Ersetzungszeichenkette
offset
Ist offset nicht negativ, beginnt die Ersetzung
ab der im Parameter offset definierten Stelle
innerhalb von string.
Ist offset negativ, wird vom Ende der
Zeichenkette string bis zum Wert von
offset rückwärts gezählt und dort mit dem
Austausch begonnen.
length
Ist der Parameter angegeben und positiv, stellt dieser Parameter die
Länge des auszuwechselnden Teils von string dar.
Ist der Wert negativ, gibt er die Zeichenzahl an, um die ab Ende von
string rückwärts gezählt wird. Bis zu dieser
Stelle erfolgt dann der Austausch. Ist der Parameter nicht angegeben,
wird standardmäßig eine Ersetzung bis zum Ende des Strings
(strlen(string )) durchgeführt, das heißt, die
Ersetzung endet mit dem Ende von string. Sollte
length den Wert Null (0)
haben, wird die Funktion die Zeichenkette
replace in string an der
durch offset bezeichneten Stelle einfügen.
&reftitle.returnvalues;
Der entstehende String wird zurückgegeben. Ist string
ein Array, wird auch ein Array zurückgegeben.
&reftitle.changelog;
&Version;&Description;8.0.0length ist jetzt ein Nullable-Typ.
&reftitle.examples;
Einfache substr_replace-Beispiele
\n";
/* Die beiden Beispiele ersetzen alle Vorkommen von
$var durch 'bob'. */
echo substr_replace($var, 'bob', 0) . " \n";
echo substr_replace($var, 'bob', 0, strlen($var)) . " \n";
/* Einfügen von 'bob' direkt am Anfang von $var. */
echo substr_replace($var, 'bob', 0, 0) . " \n";
/* Die nächsten beiden Beispiele ersetzen 'MNRPQR' in $var
durch 'bob'. */
echo substr_replace($var, 'bob', 10, -1) . " \n";
echo substr_replace($var, 'bob', -7, -1) . " \n";
/* Entfernen von 'MNRPQR' aus $var. */
echo substr_replace($var, '', 10, -1) . " \n";
?>
]]>
Nutzung von substr_replace um mehrere Zeichenketten
auf einmal zu ersetzen.
]]>
&example.outputs;
&reftitle.notes;
¬e.bin-safe;
&reftitle.seealso;
str_replacesubstrZeichenketten-Zugriff
und -Veränderung je Zeichen