substr

Назначение

Функция извлекает указанное количество символов из строкового или текстового значения.

Синтаксис

substr(string, start [, length])

Аргументы

Функция принимает три аргумента. Первые два аргумента обязательные, третий не обязательный:

  1. string. Строка из которой извлекается подстрока;

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

  3. length. Длина подстроки в символах. Если параметр length не указан, то будет возвращена подстрока, начинающаяся с позиции, указанной параметром start и длящейся до конца строки.

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

Функция возвращает текстовое значение.

Если исходное значение нулевое или аргументы неверные, функция возвращает нулевое значение.

Примеры

substr ("USA", 1, 2) возвращает "SA"

substr ("Japan", -3, 2) возвращает "pa"

substr ("Canada", 2) возвращает "nada"

substr ("Canada", -2) возвращает "da"