<substr>

(PHP 3, PHP 4, PHP 5)

substr — Возвращает подстроку

Описание

string substr ( string string, int start [, int length] )

substr() возвращает подстроку строки string длиной length , начинающегося с start символа по счету.

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

Пример 1. Пример использования substr() <?php $rest = substr("abcdef", 1);    // возвращает "bcdef" $rest = substr("abcdef", 1, 3); // возвращает "bcd" $rest = substr("abcdef", 0, 4); // возвращает "abcd" $rest = substr("abcdef", 0, 8); // возвращает "abcdef" // к отдельным символам можно обращаться с помощью фигурных скобок $string = 'abcdef'; echo $string{0};                // выводит a echo $string{3};                // выводит d ?>

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

Пример 2. Использование отрицательного start <?php $rest = substr("abcdef", -1);    // возвращает "f" $rest = substr("abcdef", -2);    // возвращает "ef" $rest = substr("abcdef", -3, 1); // возвращает "d" ?>

Если length положительный, возвращаемая строка будет не длиннее length символов. Если длина строки string меньше или равна start символов, возвращается FALSE .

Если length отрицательный, то будет отброшено указанное этим аргументом число символов с конца строки string . Если при этом позиция начала подстроки, определяемая аргументом start , находится в отброшенной части строки, возвращается пустая строка.

Пример 3. Использование отрицательного length <?php $rest = substr("abcdef", 0, -1);  // возвращает "abcde" $rest = substr("abcdef", 2, -1);  // возвращает "cde" $rest = substr("abcdef", 4, -4);  // возвращает "" $rest = substr("abcdef", -3, -1); // возвращает "de" ?>