PHP substr_replace()関数

PHP String 参考手册PHP String リファレンスマニュアル

例

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

<?php
echo substr_replace("Hello","world",0);
?>

例を実行 »

定義と使用法

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

注:start パラメータが負の数で、length が start 以下の場合、length は 0 になります。

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


構文

substr_replace(string,replacement,start,length)

パラメータ 説明
string 必須。検査する文字列を指定します。
replacement 必須。挿入する文字列を指定します。
start 必須。文字列内のどこで置換を開始するかを指定します。
  • 正の数 - 文字列の指定位置から開始
  • 負の数 - 文字列の末尾からの指定位置で開始
  • 0 - 文字列の最初の文字で開始
length 省略可能。置換する文字数を指定します。デフォルトは文字列の長さと同じです。
  • 正の数 - 置換される文字列の長さ
  • 負の数 - 文字列の末尾から数えた置換される文字数
  • 0 - 置換ではなく挿入

技術詳細

戻り値: 置換された文字列を返します。string が配列の場合は配列を返します。
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 String 参考手册PHP String リファレンスマニュアル その他の拡張機能