PHP Handbuch
Zurück |  | Weiter

# substr_replace

(PHP 4, PHP 5)

substr_replace -- Ersetzt Text innerhalb einer Zeichenkette

## Beschreibung

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

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. Der dabei entstandene String wird zurückgegeben. Ist `string` ein Array, wird auch ein Array zurückgegeben.

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.

Ist `length` 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.

Beispiel 1. substr_replace()-Beispiel

`<?php
$var = 'ABCDEFGH:/MNRPQR/';
echo "Original: $var<hr />\n";
/* Die beiden Beispiele ersetzten alle Vorkommen von
$var durch 'bob'. */
echo substr_replace($var, 'bob', 0) . "<br />\n";
echo substr_replace($var, 'bob', 0, strlen($var)) . "<br />\n";
/* Einfügen von 'bob' direkt am Anfang von $var. */
echo substr_replace($var, 'bob', 0, 0) . "<br />\n";
/* Die nächsten beiden Beispiele ersetzen 'MNRPQR' in $var
durch 'bob'. */
echo substr_replace($var, 'bob', 10, -1) . "<br />\n";
echo substr_replace($var, 'bob', -7, -1) . "<br />\n";
/* Entfernen von 'MNRPQR' aus $var. */
echo substr_replace($var, '', 10, -1) . "<br />\n";
?>`

> Anmerkung: Diese Funktion ist binary safe.

Siehe auch str_replace() und substr().

Zurück | Zum Anfang | Weiter
substr_count | Nach oben | substr