ProfiPHPProfiPHP
Категория: Функции обработки строк

Функция Substr

Функция Substr возвращает подстроку.
string substr( string $string, int $start [, int $length ] )
Функция Substr возвращает подстроку строки String, начинающейся с Start символа по счету и длиной Length символов.

В параметре String необходимо указать входную строку. Должна содержать хотя бы один символ.

Если параметр Start неотрицателен, возвращаемая подстрока начинается с позиции Start от начала строки, считая от нуля. Например, в строке 'abcdef', в позиции 0 находится символ 'a', в позиции 2 - символ 'c'.

Если Start отрицательный, возвращаемая подстрока начинается с позиции, отстоящей на Start символов от конца строки String.

Если String меньше чем Start символов, будет возвращено FALSE.

Если параметр Length положительный, возвращаемая строка будет не длиннее Length символов, начиная с параметра Start (в зависимости от длины String).

Если Length отрицательный, то будет отброшено указанное этим аргументом число символов с конца строки String (после того как будет вычислена стартовая позиция, если Start отрицателен). Если при этом позиция начала подстроки, определяемая аргументом Start, находится в отброшенной части строки или за ней, возвращается FALSE.

Если указан параметр Length и является одним из 0, FALSE или NULL, то будет возвращена пустая строка.

Если параметр Length опущен, то будет возвращена подстрока, начинающаяся с позиции, указанной параметром Start и длящейся до конца строки.

Функция Substr возвращает извлеченную часть параметра String или FALSE в случае возникновения ошибки или пустую строку.

Пример использования:
$rest = substr( "abcdef", 4 ); // возвращает "ef"
$rest = substr( "abcdef", 1, 2 ); // возвращает "bc"
$rest = substr( "abcdef", -3 ); // возвращает "def"
Если необходимо выполнить функцию Substr для многобайтовых кодировок, учитывая количество символов, используйте аналогичную функцию Mb_substr:
string mb_substr ( string $str, int $start [, int $length = NULL [, string $encoding = mb_internal_encoding() ]] )
Функция Mb_substr имеет дополнительный параметр Encoding, который представляет собой символьную кодировку. Если он опущен, вместо него будет использовано значение внутренней кодировки.

Добавить комментарий

Имя:
Текст комментария: