Дополнение строки справа
Синтаксис
rpad(<строка>, <новая длина> [, <дополняемые символы>])
<строка>
– выражение типа CHAR, VARCHAR;
<новая длина>
– беззнаковый числовой литерал;
<дополняемые символы>
– выражение типа CHAR, VARCHAR.
Описание
Функция дополняет строку заданными символами с правого края.
Если <новая длина>
больше исходной длины <строки>
, то <строка>
расширяется справа <дополняемыми символами>
до <новой длины> <строки>
(возможно, с повторением <дополняемых символов>
).
Если <дополняемые символы>
не указаны, то по умолчанию <строка>
дополняется пробелами.
Если значение <новая длина>
меньше исходной длины <строки>
, то исходная <строка>
усекается до заданной <новой длины>
справа.
Если суммарная длина аргумента <дополняемые символы>
и исходной длины <строки>
больше, чем указанная <новая длина>
, то <строка>
дополняется только частью аргумента <дополняемые символы>
. В этом случае аргумент <дополняемые символы>
усекается справа.
Возвращаемое значение
-
<Строка>
, дополненная справа указанными последовательностями символов. -
Тип возвращаемого значения совпадает с типом аргумента.
-
Если
<строка>
имеет NULL-значение, возвращается NULL-значение.
Примеры
1) line:="Коньяк "; new_line:=rpad(line,12,"*"); // Коньяк ***** 2) line:="В горах сильное"; new_line:=rpad(line,len(line)+3*len(" эхо")," эхо");// В горах сильное эхо эхо эхо