mb_strcut
(PHP 4 >= 4.0.6, PHP 5, PHP 7)
mb_strcut — 文字列の一部を得る
説明
mb_strcut
( string $str
, int $start
[, int $length = NULL
[, string $encoding = mb_internal_encoding()
]] ) : string
mb_strcut() は、ある文字列からの部分文字列の抽出を mb_substr() と同じ方法で行います。ただし、 処理は文字単位ではなくバイト単位で行います。 切り出し位置がたまたまマルチバイト文字の 2 バイト目以降だった場合、 切り出しはその文字の最初のバイトから行われます。この挙動もまた substr() 関数と異なるところです。 substr() の場合は、 マルチバイト文字の 2 バイト目以降であってもその位置から切り出しを行い、 結果的に壊れたバイト列を返すことになります。
パラメータ
str取り出しの対象となる文字列。
startstartが非負である場合に返される文字列は、strのstartバイト目以降の文字列となります (ゼロから数えます)。 たとえば、文字列 'abcdef' の0バイト目は 'a' で、2バイト目は 'c' のようになります。startが負の場合に返される文字列は、strの後ろから数えてstartバイト目以降となります。 負のstartの絶対値が文字列の長さよりも大きい場合、 返される文字列は、strの先頭から始まります。lengthバイト単位での長さ。 省略したり
NULLを指定したりした場合は、 文字列の最後までの全バイトを取り出します。lengthが負の場合、返される文字列はstrの後ろから数えてlengthバイト目で終了します。 しかし、負のlengthの絶対値がstartの位置を超える場合、空の文字列が返されます。encodingencodingパラメータには文字エンコーディングを指定します。省略した場合は、 内部文字エンコーディングを使用します。
返り値
mb_strcut() は、
start および
length パラメータで指定した
str の一部を返します。
