関数 str_replace

関数 str_replace は文字列内の 指定されたテキストを検索し、別のテキストに置き換えます。最初の パラメータは関数は置換対象を受け取り、 2番目のパラメータは置換後の内容を受け取ります。これらは 2つの文字列または2つの配列です。後者の場合、 一方の配列の対応する要素が もう一方の配列の対応する要素に置き換えられます (例を参照してください)。

構文

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

例

すべての 'a' 文字を '!' に置き換えてみましょう:

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

コード実行結果:

php'!bc!bc'

例

すべての 'a' 文字を 1 に、 'b' 文字を 2 に、 'c' 文字を 3 に置き換えてみましょう:

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

コード実行結果:

php'123123'

例

指定された複数の文字を一つの共通の 指定された文字に置き換えてみましょう:

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

コード実行結果:

php'!!!!!!'

例

配列の各要素で置換を実行してみましょう:

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

コード実行結果:

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

例

大文字と小文字は区別されます:

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

コード実行結果:

php'Abc!bc'

関連項目

  • 関数 str_ireplace,
    これは大文字と小文字を区別せずに検索と置換を行います
  • 関数 strtr,
    これも検索と置換を行います
  • 関数 substr_replace,
    これは文字列の一部を切り取り、別の文字列に置き換えます