iconv_substr
(PHP 5, PHP 7, PHP 8)
iconv_substr — 擷取字串的部分
說明
iconv_substr(
string
int
int
string
): string
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() - 獲取字元的一部分