substr_replace
Ersetzt Text innerhalb einer Zeichenkette
&reftitle.description;
mixedsubstr_replace
mixedstring
stringreplacement
intstart
intlength
substr_replace ersetzt in einer Kopie von
string alle Zeichen, die sich innerhalb der
durch die Parameter start und (optional)
length festgelegten Grenze befinden, mit der in
replacement angegebenen Zeichenkette.
&reftitle.parameters;
string
Die Eingabezeichenkette.
replacement
Die Ersetzungszeichenkette
start
Ist start positiv, beginnt die Ersetzung ab der
im Offset-Parameter start definierten Stelle
innerhalb von string.
Ist start negativ, wird vom Ende der
Zeichenkette string bis zum Wert von
start 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 haben, wird die
Funktion die Zeichenkette replacement in
string an der durch start
bezeichneten Stelle einfügen.
&reftitle.returnvalues;
Der entstehende String wird zurückgegeben. Ist string
ein Array, wird auch ein Array zurückgegeben.
&reftitle.examples;
<function>substr_replace</function>-Beispiel
\n";
/* Die beiden Beispiele ersetzten 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";
?>
]]>
&reftitle.notes;
¬e.bin-safe;
&reftitle.seealso;
str_replace
substr