(PHP 4, PHP 5, PHP 7)
substr_replace — Substitui o texto dentro de uma parte de uma string
substr_replace() substitui uma cópia de
string delimitada pelos parâmetros
start e (opcionalmente)
length com a string dada em
replacement.
stringA string de entrada.
replacementA 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.
A string de resultado é retornada. Se string é um
array, então um array será retornado.
Exemplo #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";
?>
Nota: Esta função é binary-safe.