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

Функция

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

Спецификация
 
Общие правила
  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.