substr
文字列の一部分を返す
&reftitle.description;
stringsubstr
stringstring
intoffset
intnulllength&null;
文字列 string の、offset
で指定された位置から length バイト分の文字列を返します。
&reftitle.parameters;
string
入力文字列。
offset
offset が正の場合、返される文字列は、
string の 0 から数えて
offset番目から始まる文字列となります。
例えば、文字列'abcdef'において位置
0にある文字は、'a'であり、
位置2には'c'があります。
offset が負の場合、返される文字列は、
stringの後ろから数えて
offset番目から始まる文字列となります。
string の長さが
offset 文字より短い場合は、
空の文字列が返されます。
負の offset の使用
]]>
length
length が指定され、かつ正である場合、
返される文字列は offset
(string の長さに依存します)
から数えてlength文字数分となります。
length が指定され、かつ負である場合、
string の終端からその文字数分の文字が省略されます。
もし offset が切り出し位置を超える場合、
空の文字列が返されます。
length が指定され、かつ
0 であれば、空の文字が返されます。
length を省略した場合、または &null; の場合は、
offset の位置から文字列の最後までの部分文字列を返します。
負の length の使用
]]>
&reftitle.returnvalues;
string の一部を返すか、空文字列を返します。
&reftitle.changelog;
&Version;
&Description;
8.0.0
length は、nullable になりました。
length に明示的に &null; を設定すると、
文字列の最後までを含む部分文字列を返すようになっています。
これより前のバージョンでは、空文字列を返していました。
8.0.0
この関数は、前のバージョンで &false; を返す場合に、空文字列を返すようになりました。
&reftitle.examples;
基本的な substr の使用法
]]>
substr でのキャストの挙動
]]>
&example.outputs;
文字列の範囲が不正な場合
指定された文字列の範囲が正しくない場合、
substr は PHP 8.0.0 以降では空文字列を返します。
それより前のバージョンでは、&false; を返していました。
]]>
&example.outputs.8;
&example.outputs.7;
&reftitle.seealso;
strrchr
substr_replace
preg_match
trim
mb_substr
wordwrap
文字列への文字単位のアクセスと修正