Дополнение строки справа

Функция

Дополнение строки справа заданными символами.

Спецификация
 
Общие правила
  1. В качестве < строки > можно использовать выражения типа CHAR, VARCHAR, NCHAR, NCHAR VARYING.

  2. Если < новая длина > больше исходной длины < строки >, то < строка > расширяется справа < дополняемыми символами > до < новой длины > < строки > (возможно, с повторением < дополняемых символов >).

  3. Если < дополняемые символы > не указаны, по умолчанию < строка > дополняется пробелами.

  4. Если значение < новая длина > меньше исходной длины < строки >, то исходная < строка > усекается до заданной < новой длины > справа.

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

  6. Все аргументы функции могут быть заданы < SQL-параметром >, который должен содержать спецификацию типа данных параметра.

    select rpad(? (char(20)), ? (double), ? (char(10)));
    Тестовая строка
    30.67
    12345678
    |Тестовая строка12345678 12345|

Возвращаемое значение
  1. < Строка >, дополненная справа указанными последовательностями символов. Длина < строки > – максимум из исходной длины < строки > и < длины >.

  2. Тип возвращаемого значения совпадает с типом аргумента.

  3. Если аргумент NULL, результат NULL.