iconv_substr

(PHP 5, PHP 7, PHP 8)

iconv_substr — 截取字符串的部分

说明

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

根据 offset 和 length 参数指定 str 截取的部分。

参数

str

原始字符串。

offset

如果 offset 是非负数，iconv_substr() 从 str 开头第 offset 个字符开始截出部分，从 0 开始计数。

如果 offset 是负数，iconv_substr() 从 str 末尾向前 offset 个字符开始截取。

length

如果指定了 length 并且是正数，返回的值从 offset 截取部分，最多包含 length 个字符（取决于 string 的长度）。

如果传入了负数的 length， iconv_substr() 将从第 offset 个字符到离末尾 length 个字符截出 str 的部分。如果 offset 也是负数，则开始位置计算规则的解释见以上。

charset

如果省略了参数 charset，string 的编码被认定为 iconv.internal_encoding。

注意，offset 和 length 参数总是被认为字符表现的偏移，基于 charset 检测到的字符集进行统计计算，而相对应的 substr() 则是基于字节的位移来计算。

返回值

返回 offset 和 length 参数指定的 str 的部分。

如果 str 比 offset 字符数更短，将会返回 false。如果 str 是 offset 个字符的长度，将返回空字符串。

更新日志

版本	说明
7.0.11	如果 `str` 等长于 `offset` 个字符，将返回空字符串。之前的版本里，这种情况是会返回 `false` 的。

参见

substr() - 返回字符串的子串
mb_substr() - 获取部分字符串
mb_strcut() - 获取字符的一部分

add a note

User Contributed Notes 2 notes

down

-2

doru87 at gmail dot com ¶

12 years ago


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

down

-8

qbolec at terra dot es ¶

15 years ago


<?=
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