iconv_substr

(PHP 5, PHP 7, PHP 8)

iconv_substr — 截取字符串的部分

說(shuō)明

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

根據(jù) offset 和 length 參數(shù)指定 str 截取的部分。

參數(shù)

str

原始字符串。

offset

如果 offset 是非負(fù)數(shù)，iconv_substr() 從 str 開(kāi)頭第 offset 個(gè)字符開(kāi)始截出部分，從 0 開(kāi)始計(jì)數(shù)。

如果 offset 是負(fù)數(shù)，iconv_substr() 從 str 末尾向前 offset 個(gè)字符開(kāi)始截取。

length

如果指定了 length 并且是正數(shù)，返回的值從 offset 截取部分，最多包含 length 個(gè)字符（取決于 string 的長(zhǎng)度）。

如果傳入了負(fù)數(shù)的 length， iconv_substr() 將從第 offset 個(gè)字符到離末尾 length 個(gè)字符截出 str 的部分。 如果 offset 也是負(fù)數(shù)，則開(kāi)始位置計(jì)算規(guī)則的解釋見(jiàn)以上。

charset

如果省略了參數(shù) charset，string 的編碼被認(rèn)定為 iconv.internal_encoding。

注意，offset 和 length 參數(shù)總是被認(rèn)為字符表現(xiàn)的偏移，基于 charset 檢測(cè)到的字符集進(jìn)行統(tǒng)計(jì)計(jì)算，而相對(duì)應(yīng)的 substr() 則是基于字節(jié)的位移來(lái)計(jì)算。

返回值

返回 offset 和 length 參數(shù)指定的 str 的部分。

如果 str 比 offset 字符數(shù)更短，將會(huì)返回 false。 如果 str 是 offset 個(gè)字符的長(zhǎng)度，將返回空字符串。

更新日志

版本 說(shuō)明
7.0.11 如果 str 等長(zhǎng)于 offset 個(gè)字符， 將返回空字符串。之前的版本里，這種情況是會(huì)返回 false 的。

參見(jiàn)