iconv_substr
(PHP 5, PHP 7, PHP 8)
iconv_substr — 截取字符串的部分
说明
string
$string,int
$offset,?int
$length = null,?string
$encoding = null): string|false
根据 offset 和 length 参数指定 string 截取的部分。
参数
string-
原始字符串。
offset-
如果
offset是非负数,iconv_substr() 从string开头第offset个字符开始截出部分,从 0 开始计数。如果
offset是负数,iconv_substr() 从string末尾向前offset个字符开始截取。 length-
如果指定了
length并且是正数,返回的值从offset截取部分,最多包含length个字符(取决于string的长度)。如果传入了负数的
length, iconv_substr() 将从第offset个字符到离末尾length个字符截出string的部分。 如果offset也是负数,则开始位置计算规则的解释见以上。 encoding-
如果省略了参数
encoding,string的编码被认定为 iconv.internal_encoding。注意,
offset和length参数总是被认为字符表现的偏移,基于encoding检测到的字符集进行统计计算,而相对应的 substr() 则是基于字节的位移来计算。
返回值
返回 offset 和 length 参数指定的 string 的部分。
如果 string 比 offset 字符数更短,将会返回 false。
如果 string 是 offset 个字符的长度,将返回空字符串。
更新日志
| 版本 | 说明 |
|---|---|
| 8.0.0 |
length 和 encoding 现在可为 null。
|
| 7.0.11 |
如果 string 等于 offset 个字符,将返回空字符串。之前的版本里,这种情况会返回 false。
|
用户贡献的备注 1 note
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备份地址:http://www.lvesu.com/blog/php/function.iconv-substr.php