substr()

Назначение

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

Синтаксис и аргументы

substr(строка, число, [число])

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

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

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

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

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

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

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

Примеры

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

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

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

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