iconv_substr
(PHP 5, PHP 7)
iconv_substr — Получение части строки
Описание
$string
, int $offset
, int|null $length = null
, string|null $encoding = null
) : string|false
Получает часть строки string, определенную
параметрами offset и length.
Список параметров
-
string -
Изначальная строка.
-
offset -
Если
offsetнеотрицателен, iconv_substr() получает часть строкиstringначиная с символа с порядковым номеромoffset(нумерация начинается с нуля).Если
offsetотрицателен, iconv_substr() получает часть строки начиная с позиции, отстоящую от конца строкиstringнаoffsetсимволов. -
length -
Если
lengthзадан и положителен, возвращаемое значение содержит не болееlengthсимволов, начиная сoffset(зависит от длины строкиstring).Если указан отрицательный
length, iconv_substr() получает часть строкиstring, начиная сoffsetсимвола и до символа, отстоящего от конца строки наlengthсимволов. В случае, еслиoffsetтакже отрицателен, стартовая позиция вычисляется заранее в соответствии с вышеописанным правилом. -
encoding -
Если параметр
encodingне указан, предполагается, что строкаstringимеет кодировку iconv.internal_encoding.Обратите внимание, что и
offset, иlengthосновываются на размере символа, рассчитанного исходя из кодировки текста (encoding), в то время как схожая функция substr() всегда рассматривает их побайтовое смещение.
Возвращаемые значения
Возвращает часть строки string, определенную
параметрами offset и length.
Если строка string имеет меньшую длину, чем
параметр offset, будет возвращено
false.
Если string имеет длину равную offset,
будет возвращена пустая строка.
Список изменений
| Версия | Описание |
|---|---|
| 8.0.0 |
length и encoding теперь допускают значение null.
|
| 7.0.11 |
Если string имеет длину равную offset,
будет возвращена пустая строка. Ранее в подобных случаех возвращалось false.
|
Смотрите также
- substr() - Возвращает подстроку
- mb_substr() - Возвращает часть строки
- mb_strcut() - Получение части строки