iconv_substr

(PHP 5, PHP 7)

iconv_substrПолучение части строки

Описание

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

Получает часть строки str, определенную параметрами offset и length.

Список параметров

str

Изначальная строка.

offset

Если offset неотрицателен, iconv_substr() получает часть строки str начиная с символа с порядковым номером offset (нумерация начинается с нуля).

Если offset отрицателен, iconv_substr() получает часть строки начиная с позиции, отстоящую от конца строки str на offset символов.

length

Если length задан и положителен, возвращаемое значение содержит не более length символов, начиная с offset (зависит от длины строки string).

Если указан отрицательный length, iconv_substr() получает часть строки str, начиная с offset символа и до символа, отстоящего от конца строки на length символов. В случае, если offset также отрицателен, стартовая позиция вычисляется заранее в соответствии с вышеописанным правилом.

charset

Если параметр charset не указан, предполагается, что строка string имеет кодировку iconv.internal_encoding.

Обратите внимание, что и offset, и length основываются на размере символа, рассчитанного исходя из кодировки текста, в то время как схожая функция substr() всегда рассматривает их побайтовое смещение.

Возвращаемые значения

Возвращает часть строки str, определенную параметрами offset и length.

Если строка str имеет меньшую длину, чем параметр offset, будет возвращено FALSE. Если str имеет длину равную offset, будет возвращена пустая строка.

Список изменений

Версия Описание
7.0.11 Если str имеет длину равную offset, будет возвращена пустая строка. Ранее в подобных случаех возвращалось FALSE.

Смотрите также

  • substr() - Возвращает подстроку
  • mb_substr() - Возвращает часть строки
  • mb_strcut() - Получение части строки