string substr_replace(string string, string replacement, int start, int [length]);substr_replaceは、文字列string の start および(オプションの) length パラメータで区切られた部分を replacement で指定した文字列に置換します。結果が返されます。
start が正の場合、置換は、string でstart番目に文字から始まります。
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 も参照下さい。
注意: substr_replace は、PHP 4.0 で追加されました。