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() - Получение части строки