Função substr_replace

A função substr_replace substitui uma parte especificada de uma string por outra. Esta função corta uma parte especificada da string (os parâmetros indicam de onde começar o corte e quantos caracteres tomar) e substitui a parte cortada pela string especificada. Se o último parâmetro não for especificado - a substituição será feita até o final da string.

Sintaxe

phpsubstr_replace(array|string $string, array|string $replace, array|int $offset, array|int|null $length = null): string|array

Exemplo

Vamos cortar da string os caracteres, começando do primeiro (a contagem dos caracteres começa do zero), 3 unidades e, em vez delas, inserir '!!!':

php<?php
  echo substr_replace('abcde', '!!!', 1, 3);
?>

Resultado da execução do código:

php'a!!!e'

Exemplo

Vamos cortar da string os caracteres, começando do primeiro até o final da string (já que o último parâmetro não foi especificado) e, em vez deles, inserir '!!!':

php<?php
  echo substr_replace('abcde', '!!!', 1);
?>

Resultado da execução do código:

php'a!!!'

Veja também

  • a função str_replace,
    que realiza busca e substituição em uma string
  • a função substr,
    que extrai parte de uma string