substr_count
substr
Funções para String
PHP Manual

# 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

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";
?>`

### Notas

> Nota: 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

substr_count
substr
Funções para String
PHP Manual