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の終端まで置換することになります。

例 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() も参照ください。