FirebirdSQL logo

RIGHT()

Доступно в

DSQL, PSQL

Синтаксис
RIGHT (string, length)
Table 1. Параметры функции RIGHT
Параметр Описание

string

Выражение строкового типа.

length

Целое число.Определяет количество возвращаемых символов.

Тип возвращаемого результата:

VARCHAR или BLOB

Функция RIGHT возвращает конечную (правую) часть входной строки.Длина возвращаемой подстроки определяется вторым параметром.

Особенности использования:

  • Функция поддерживает текстовые блоки любой длины и с любыми наборами символов;

  • Если строковый аргумент BLOB, результатом будет BLOB, в противном случае результатом будет VARCHAR(N), при этом N — будет равно длине строкового параметра;

  • Если числовой параметр превысит длину текста, результатом будет исходный текст.

Warning

При использовании BLOB в параметрах функции может потребоваться загрузить объект полностью в память.При больших объёмах BLOB могут наблюдаться потери производительности.

Example 1. Использование функции RIGHT
SELECT RIGHT('ABC', 1) FROM rdb$database;
-- результат C

RPAD()

Доступно в

DSQL, PSQL

Синтаксис
RPAD (str, endlen [, padstr])
Table 1. Параметры функции RPAD
Параметр Описание

str

Выражение строкового типа.

endlen

Длина выходной строки.

padstr

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

Тип возвращаемого результата:

VARCHAR или BLOB

Функция RPAD дополняет справа входную строку пробелами или определённой пользователем строкой до заданной длины.

Особенности использования:

  • Функция поддерживает текстовые блоки любой длины и с любыми наборами символов;

  • Если входная строка имеет тип BLOB, то результат также будет BLOB, в противном случае результат будет VARCHAR(endlen).

  • Если аргумент padstr задан, но равен '' (пустой строке), то дополнения строки не происходит! В случае если endlen меньше длины входной строки, то в результате происходит её усечение до длины endlen, даже если параметр padstr равен пустой строке.

Warning

При использовании BLOB в параметрах функции может потребоваться загрузить объект полностью в память.При больших объёмах BLOB могут наблюдаться потери производительности.

Примеры RPAD

Example 1. Использование функции RPAD
RPAD ('Hello', 12)                -- возвращает 'Hello       '
RPAD ('Hello', 12, '-')           -- возвращает 'Hello-------'
RPAD ('Hello', 12, '')            -- возвращает 'Hello'
RPAD ('Hello', 12, 'abc')         -- возвращает 'Helloabcabca'
RPAD ('Hello', 12, 'abcdefghij')  -- возвращает 'Helloabcdefg'
RPAD ('Hello', 2)                 -- возвращает 'He'
RPAD ('Hello', 2, '-')            -- возвращает 'He'
RPAD ('Hello', 2, '')             -- возвращает 'He'
См. также:

[fblangref-scalarfuncs-lpad].

ASCII_VAL()

Доступно в

DSQL, PSQL

Синтаксис
ASCII_VAL (ch)
Table 1. Параметры функции ASCII_VAL
Параметр Описание

ch

Строка типа данных [VAR]CHAR или текстовый BLOB максимального размера 32767 байт.

Тип возвращаемого результата:

SMALLINT

Функция ASCII_VAL возвращает ASCII код символа, переданного в качестве аргумента.

Особенности использования:

  • Если строка содержит более одного символа, то возвращается код первого символа строки;

  • Если строка пустая, возвращается ноль;

  • Если аргумент NULL, то возвращаемое значение также NULL.