substr()

Назначение

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

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

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

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

  • строка, из которой извлекается подстрока;

  • число – начальная позиция подстроки, отсчитывается от нуля.

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

Третий аргумент представленяет собой длину подстроки в символах (типа Целое число).

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

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

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

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

Примеры

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

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

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

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