substr_replace
(PHP 4, PHP 5)
substr_replace — 文字列の一部を置換する
説明
substr_replace()は、文字列 string の start および (オプションの) length パラメータで区切られた部分を replacement で指定した文字列に置換します。
パラメータ
- string
-
入力文字列。
- replacement
-
置換する文字列。
- start
-
start が正の場合、置換は string で start 番目の文字から始まります。
start が負の場合、置換は string の終端から start 番目の文字から始まります。
- length
-
正の値を指定した場合、 string の置換される部分の長さを表します。 負の場合、置換を停止する位置が string の終端から何文字目であるかを表します。このパラメータが省略された場合、 デフォルト値は strlen(string )、すなわち、 string の終端まで置換することになります。 当然、もし length がゼロだったら、 この関数は string の最初から start の位置に replacement を挿入するということになります。
返り値
結果の文字列を返します。もし、string が配列の場合、配列が返されます。
例
Example#1 substr_replace() の例
<?php
$var = 'ABCDEFGH:/MNRPQR/';
echo "Original: $var<hr />\n";
/* 以下の2つの例は、全ての $var で 'bob' で置換します。 */
echo substr_replace($var, 'bob', 0) . "<br />\n";
echo substr_replace($var, 'bob', 0, strlen($var)) . "<br />\n";
/* $var の先頭に 'bob' を挿入します */
echo substr_replace($var, 'bob', 0, 0) . "<br />\n";
/* 次の2つの例は、$var の 'MNRPQR' を 'bob'で置換します */
echo substr_replace($var, 'bob', 10, -1) . "<br />\n";
echo substr_replace($var, 'bob', -7, -1) . "<br />\n";
/* $var から 'MNRPQR' を削除します */
echo substr_replace($var, '', 10, -1) . "<br />\n";
?>
注意
注意: この関数はバイナリデータに対応しています。