left

Назначение

Функция left извлекает определенное количество символов с начала строкового или текстового значения. Количество символов, которое необходимо извлечь, указано в одном из аргументов.

Среди подобных функций - функция right, которая отличается от функции left тем, что отсчет начинается с конца, а также функция mid, которая работает по тому же принципу, но действует от конца строки.

Синтаксис

left (строка,число)

Аргументы

Функция left требует наличия двух аргументов:

  1. Первый аргумент должен быть строковыми или текстовым значением. Это значение, в котором функция будет осуществлять поиск, т.е. источник символов.

  2. Второй аргумент должен быть целочисленным (больше или равен 0). Второй аргумент - это количество символов для возврата.

Вы также можете использовать подстроки, которые определяют точку(точки), от которой (или между которыми) необходимо извлечь результат. См. примеры далее:

left("abcdefgh", "b") возвращает "a" (обработка выполняется до подстроки "b", не включая данную подстроку)

left("abcdefgh", "b", include:=yes) возвращает "ab" (обработка выполняется до подстроки "b", включая данную подстроку)

isnull(left("abcdefgh", "x", optional:=no))

left("abcdefgh", "x", optional:=yes) возвращает "abcdefgh" (возвращает всю строку)

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

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

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

Примеры

left ("Hello There",4) возвращает Hell.

left ("How is it going?",5) возвращает How i