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 文字より短い場合は、 空の文字列が返されます。 負の <parameter>offset</parameter> の使用 ]]> length length が指定され、かつ正である場合、 返される文字列は offset (string の長さに依存します) から数えてlength文字数分となります。 length が指定され、かつ負である場合、 string の終端からその文字数分の文字が省略されます。 もし offset が切り出し位置を超える場合、 空の文字列が返されます。 length が指定され、かつ 0 であれば、空の文字が返されます。 length を省略した場合、または &null; の場合は、 offset の位置から文字列の最後までの部分文字列を返します。 負の <parameter>length</parameter> の使用 ]]> &reftitle.returnvalues; string の一部を返すか、空文字列を返します。 &reftitle.changelog; &Version; &Description; 8.0.0 length は、nullable になりました。 length に明示的に &null; を設定すると、 文字列の最後までを含む部分文字列を返すようになっています。 これより前のバージョンでは、空文字列を返していました。 8.0.0 この関数は、前のバージョンで &false; を返す場合に、空文字列を返すようになりました。 &reftitle.examples; 基本的な <function>substr</function> の使用法 ]]> <function>substr</function> でのキャストの挙動 ]]> &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 文字列への文字単位のアクセスと修正