substr_replace
(PHP 4, PHP 5)
substr_replace — Substitui o texto dentro de uma parte de uma string
Descrição
substr_replace() substitui uma cópia de string delimitada pelos parâmetros start e (opcionalmente) length com a string dada em replacement .
Parâmetros
- string
-
A string de entrada.
- replacement
-
A string substituta.
- start
-
Se start é positivo, a substituição começará no start -ésimo caractere da string .
Se start é negativo, a substituição começará no start -ésimo caractere do final de string .
- length
-
Se dado e é positivo, ele representa o comprimento da porção de string que é para ser substituída. Se ele é negativo, ele representa o número de caracteres do final de string para parar de substituir. Se ele não é dado, então o padrão será até strlen( string ); i.e. o fim da substituição no final de string . Obviamente, se length é zero então esta função irá ter efeito de inserir replacement em string na dada posição start .
Valor Retornado
A string de resultado é retornada. Se string é um array, então um array será retornado.
Exemplos
Example#1 substr_replace() exemplo
<?php
$var = 'ABCDEFGH:/MNRPQR/';
echo "Original: $var<hr />\n";
/* Estes dois exemplos substituem tudo de $var com 'bob'. */
echo substr_replace($var, 'bob', 0) . "<br />\n";
echo substr_replace($var, 'bob', 0, strlen($var)) . "<br />\n";
/* Insere 'bob' direto no começo de $var. */
echo substr_replace($var, 'bob', 0, 0) . "<br />\n";
/* Estes dois exemplos substituem 'MNRPQR' em $var com 'bob'. */
echo substr_replace($var, 'bob', 10, -1) . "<br />\n";
echo substr_replace($var, 'bob', -7, -1) . "<br />\n";
/* Deleta 'MNRPQR' de $var. */
echo substr_replace($var, '', 10, -1) . "<br />\n";
?>
Notas
Nota: Esta função é compatível com dados binários