[edit] Last updated: Fri, 25 May 2012

iconv_substr

(PHP 5)

iconv_substr — 文字列の一部を切り出す

説明

string iconv_substr ( string $str , int $offset [, int $length = iconv_strlen($str, $charset) [, string $charset = ini_get("iconv.internal_encoding") ]] )

文字列 str の、 start と length で指定された一部を返します。

パラメータ

str

元の文字列。

offset

start が負でない場合、 iconv_substr() は str の start 番目の文字（ゼロから数えて）から切り出します。

start が負の場合、 iconv_substr() は str の最後から数えて start 番目の文字から切り出します。

length

length が指定され、かつ正である場合、返される文字列は start から数えて最大 length 文字数分となります (string の長さに依存します)。

もし負の length が渡された場合に iconv_substr() が切り出す文字列は、 str の start 番目の文字からはじまり、文字列の最後から数えて length 文字分戻ったところまでとなります。 start も負の場合、開始位置は上で説明した方式で計算されます。

charset

charset が指定されなかった場合、文字セットは ini 設定 iconv.internal_encoding で定義された値とみなされます。

offset や length のパラメータは、常に charset で定義された文字セットにおける文字数と判断されることに注意してください。一方、substr() の場合はこれらの値を常にバイト数として判断します。

返り値

文字列 str の、 offset と length で指定された一部を返します。

もし str が start の文字列長より短い場合は、FALSE が返されます。

参考

substr() - 文字列の一部分を返す
mb_substr() - 文字列の一部を得る
mb_strcut() - 文字列の一部を得る

add a note User Contributed Notes iconv_substr

doru87 at gmail dot com 21-Jan-2010 05:29


just fyi, iconv_substr() unknown error (0) has been resolved in PHP 5.2



you can also try mb_substr() or just substr() when dealing with this issue. Unfortunately there is no way to fix it in versions prior to 5.2.



Regards,

Teodor Sandu

qbolec at terra dot es 25-May-2007 02:07


<?=

iconv_substr("A",0,1);

?>

generates folowing error:

Notice: iconv_substr() [function.iconv-substr]: Unknown error (0) in [...]



while, <?= iconv_substr("AB",0,1) ?> and <?= iconv_substr("AB",0,2) ?>

work as expected.

add a note