Funkcja str_replace

Funkcja str_replace wyszukuje w ciągu znaków określony tekst i zamienia go na inny. Pierwszym parametrem funkcja przyjmuje to, co zamieniamy, a drugim - na co zamieniamy. Mogą to być dwa ciągi znaków lub dwie tablice. W drugim przypadku odpowiednie elementy jednej tablicy zostaną zastąpione przez odpowiednie elementy drugiej tablicy (patrz przykłady).

Składnia

phpstr_replace(array|string $search, array|string $replace, string|array $subject, int &$count = null): string|array

Przykład

Zamieńmy wszystkie litery 'a' na '!':

php<?php
  echo str_replace('a', '!', 'abcabc');
?>

Wynik wykonania kodu:

php'!bc!bc'

Przykład

Zamieńmy wszystkie litery 'a' na 1, litery 'b' na 2, litery 'c' na 3:

php<?php
  echo str_replace(['a', 'b', 'c'], [1, 2, 3], 'abcabc');
?>

Wynik wykonania kodu:

php'123123'

Przykład

Zamieńmy określone litery na jeden wspólny określony znak:

php<?php
  echo str_replace(['a', 'b', 'c'], '!', 'abcabc');
?>

Wynik wykonania kodu:

php'!!!!!!'

Przykład

Wykonajmy zamianę w każdym elemencie tablicy:

php<?php
  $arr = ['abc', 'abc', 'abc'];
  $res = str_replace('a', '!', $arr);
  print_r($res);
?>

Wynik wykonania kodu:

php['!bc', '!bc', '!bc']

Przykład

Wielkość liter ma znaczenie:

php<?php
  echo str_replace('a', '!', 'Abcabc');
?>

Wynik wykonania kodu:

php'Abc!bc'

Zobacz też

  • funkcję str_ireplace,
    która wykonuje wyszukiwanie i zamianę bez uwzględniania wielkości liter
  • funkcję strtr,
    która również wykonuje wyszukiwanie i zamianę
  • funkcję substr_replace,
    która wycina część ciągu znaków i zastępuje ją inną