substr_replace

(PHP 4, PHP 5)

substr_replace -- 文字列の一部を置換する

説明

mixed substr_replace ( mixed string, string replacement, int start [, int length] )

substr_replace()は、文字列 stringstart およ び(オプションの) length パラメータで区切ら れた部分を replacement で指定した文字列に 置換します。結果が返されます。もし、string が配列の場合、配列が返されます。

startが正の場合、置換は stringstart番目 に文字から始まります。

start が負の場合、置換は string の終端から start番目の文字から始まります。

length が指定されかつ正の場合、 string の置換される部分の長さを表します。 負の場合、置換を停止する位置が string の終端から何文字目であるかを表します。このパラメータが省略された場合、 デフォルト値は strlen(string)、すなわち、 string の終端まで置換することになります。 当然、もし length がゼロだったら、 この関数は string の最初から start の位置に replacement を挿入するということになります。

例 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";
?>

注意: この関数はバイナリデータに対応しています。

str_replace()およびsubstr() も参照ください。