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