(PHP 4, PHP 5)
substr_replace — Zastępuje tekst wewnątrz części łańcucha
substr_replace() zastępuje kopię
string ograniczoną przez parametry
start i (opcjonalnie)
długość do łańcucha podanym w
replacement. W rezultacie zwracany jest łańcuch.
Jeżeli string jest tablicą, wtedy zwracana jest tablica.
Jeżeli start jest dodatni, zastąpienie
będzie zaczynać się od start znaku w
string.
Jeżelistart jest ujemny, zastąpienie będzie
zaczynać się odstart znaku od
końcastring.
Jeślidługość jest podana i jest dodatnia,
stanowi długość części
string która będzie zastąpiona. Jeśli jest
ujemna, stanowi liczbę znaków od końca
string po których ma być zatrzymane zastępowanie. Jeśli
nie jest podana, wtedy domyślnie wynosi strlen(
string ); tj. koniec zastąpienia na
końcustring. Oczywiście, jeśli
długość jest zerem wtedy funkcja będzie powodowała
efekt wstawienia replacement w
string w określonym przez
start miejscu.
Przykład #1 substr_replace() przykłady
<?php
$var = 'ABCDEFGH:/MNRPQR/';
echo "Original: $var<hr />\n";
/* Te dwa przykłady zastępują całość $var ciągiem 'bob'. */
echo substr_replace($var, 'bob', 0) . "<br />\n";
echo substr_replace($var, 'bob', 0, strlen($var)) . "<br />\n";
/* Wstawia 'bob' odpowiednio na początku $var. */
echo substr_replace($var, 'bob', 0, 0) . "<br />\n";
/* Następne zastępują 'MNRPQR' w $var ciągiem 'bob'. */
echo substr_replace($var, 'bob', 10, -1) . "<br />\n";
echo substr_replace($var, 'bob', -7, -1) . "<br />\n";
/*Usuwa 'MNRPQR' z $var. */
echo substr_replace($var, '', 10, -1) . "<br />\n";
?>
Informacja: Ta funkcja jest bezpieczna dla danych binarnych.
Patrz również str_replace() i substr().