substr_replace
文字列の一部を置換する
&reftitle.description;
stringarraysubstr_replace
arraystringstring
arraystringreplace
arrayintoffset
arrayintnulllength&null;
substr_replaceは、文字列
stringの offset および
(オプションの) length パラメータで区切られた部分を
replace で指定した文字列に置換します。
&reftitle.parameters;
string
入力文字列。
文字列の配列を指定することもでき、各文字列について順に置換を行います。
この場合、他のパラメータ replace、offset
および length がスカラ値なら
それを各入力文字列に順次適用し、配列なら各入力文字列に対応する要素の値を適用します。
replace
置換する文字列。
offset
offset が負ではない場合、置換は
string で offset
番目の文字から始まります。
offset が負の場合、置換は
string の終端から
offset 番目の文字から始まります。
length
正の値を指定した場合、
string の置換される部分の長さを表します。
負の場合、置換を停止する位置が string
の終端から何文字目であるかを表します。このパラメータが省略された場合、
デフォルト値は strlen(string)、すなわち、
string の終端まで置換することになります。
当然、もし length がゼロだったら、
この関数は string の最初から
offset の位置に
replace を挿入するということになります。
&reftitle.returnvalues;
結果の文字列を返します。もし、string
が配列の場合、配列が返されます。
&reftitle.changelog;
&Version;
&Description;
8.0.0
length は、nullable になりました。
&reftitle.examples;
シンプルな substr_replace の例
\n";
/* 以下の2つの例は、全ての $var で 'bob' で置換します。 */
echo substr_replace($var, 'bob', 0) . "
\n";
echo substr_replace($var, 'bob', 0, strlen($var)) . "
\n";
/* $var の先頭に 'bob' を挿入します */
echo substr_replace($var, 'bob', 0, 0) . "
\n";
/* 次の2つの例は、$var の 'MNRPQR' を 'bob'で置換します */
echo substr_replace($var, 'bob', 10, -1) . "
\n";
echo substr_replace($var, 'bob', -7, -1) . "
\n";
/* $var から 'MNRPQR' を削除します */
echo substr_replace($var, '', 10, -1) . "
\n";
?>
]]>
substr_replace で複数の文字列を一度に置換する例
]]>
&example.outputs;
&reftitle.notes;
¬e.bin-safe;
&reftitle.seealso;
str_replace
substr
文字列への文字単位のアクセスと修正