PHP substr_replace() 関数

❮ PHP 文字列リファレンス

例

"Hello"を "world"に置き換えます：

<?php
echo substr_replace("Hello","world",0);
?>
例の実行 »

定義と用法

substr_replace() 関数は、文字列の一部を別の文字列に置き換えます。

注: startパラメーターが負で、長さが start 以下である場合、長さは0になります。

注: この関数はバイナリセーフです。

構文

substr_replace(string,replacement,start,length)

パラメータ 説明
string 必須。チェックする文字列を指定する
replacement 必須。置換する文字を指定する
start 必須。 文字列の置換を開始する場所を指定する
  • 正の数 - 文字列の指定した位置から置換を開始する
  • 負の数 - 文字列の後から数えた指定位置から置換を開始する
  • 0 - 文字列の後から数えた指定位置から置換を開始する
length 任意。置換する文字数を指定する。デフォルトは文字列と同じ長さ。
  • 正の数 - 置換する文字列の長さ
  • 負の数 - 置換後に文字列の最後に残す文字数
  • 0 - 置換の代わりに挿入を行う

技術内容
返り値： 置換した文字列を返します。文字列が配列の場合、配列が返されます
PHP バージョン： 4+
変更歴 PHP 4.3.3以降、すべてのパラメータに配列が指定できるようになりました

その他の例

例 1

文字列の6番目の位置から置換を開始します（ "world"を "earth"に置き換えます）：

<?php
echo substr_replace("Hello world","earth",6);
?>
例の実行 »

例 2

文字列の最後から5番目の位置から置換を開始します（ "world"を "earth"に置き換えます）：

<?php
echo substr_replace("Hello world","earth",-5);
?>
例の実行 »

例 3

"world"の先頭に "Hello"を挿入します：

<?php
echo substr_replace("world","Hello ",0,0);
?>
例の実行 »

例 4

一度に複数の文字列を置き換えます。各文字列の "AAA" を "BBB" に置き換えます：

<?php
$replace = array("1: AAA","2: AAA","3: AAA");
echo implode("<br>",substr_replace($replace,'BBB',3,3));
?>
例の実行 »
❮ PHP 文字列リファレンス