substr_replace

(PHP 4 )

substr_replace -- Ersetzt Text in einer Zeichenkette

Beschreibung:

string substr_replace ( string string, string replacement, int start [, int length])

substr_replace() ersetzt den Teil von string, der durch die Parameter start und (optional) length begrenzt wird mit der in replacement angegeben Zeichnekette. Das Ergebnis wird zurück gegeben.

Ist start positiv, beginnt der Austausch am Offset start 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.

Ist length angegeben und positive, stellt dieser Parameter die Länge des auszuwechselnden Teilstrings dar. Ist length angegeben und 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 length nicht angegeben, wird unterstellt, dass Sie die Ersetzung bis zum String-Ende (strlen(string )) bezwecken.

Beispiel 1. substr_replace()-Beispiel:

<?php
$var = 'ABCDEFGH:/MNRPQR/';
echo "Original: $var<hr>\n";

/* Diese 2 Beispiele ersetzen alles in $var mit 'bob'. */
echo substr_replace ($var, 'bob', 0) . "<br>\n";
echo substr_replace ($var, 'bob', 0, strlen ($var)) . "<br>\n";

/* Fügt 'bob' am Anfang von $var ein . */
echo substr_replace ($var, 'bob', 0, 0) . "<br>\n";

/* Die nächsten beiden ersetzen 'MNRPQR' in $var durch 'bob'. */
echo substr_replace ($var, 'bob', 10, -1) . "<br>\n";
echo substr_replace ($var, 'bob', -7, -1) . "<br>\n";

/* Löscht 'MNRPQR' aus $var. */
echo substr_replace ($var, '', 10, -1) . "<br>\n";
?>

Sieehe auch str_replace() und substr().

Anmerkung: substr_replace() existiert ab PHP 4.0.