substr_replace

(PHP 4, PHP 5)

substr_replace — Substitui o texto dentro de uma parte de uma string

Descrição

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

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

Note: Esta função é binary-safe.

Veja Também

  • str_replace() - Substitui todas as ocorrências da string de procura com a string de substituição
  • substr() - Retorna uma parte de uma string