Дополнение строки слева
Синтаксис
lpad(< строка >, < новая длина > [, < дополняемые символы >])
< строка >
– выражение типа CHAR, VARCHAR;
< новая длина >
– беззнаковый числовой литерал;
< дополняемые символы >
– выражение типа CHAR, VARCHAR.
Описание
Функция дополняет строку заданными символами с левого края.
Если < новая длина >
больше исходной длины < строки >
, то < строка >
расширяется слева < дополняемыми символами >
до < новой длины >
< строки >
(возможно, с повторением < дополняемых символов >
).
line:="12345"; new_line:=lpad(line, 12, "abc"); // abcabca12345
Если < дополняемые символы >
не указаны, то по умолчанию < строка >
дополняется пробелами.
Если значение < новая длина >
меньше исходной длины < строки >
, то исходная < строка >
усекается до заданной < новой длины >
справа.
line:="12345"; new_line:=lpad(line, 3, '**'); // 123
Если суммарная длина аргумента < дополняемые символы >
и исходной длины < строки >
больше, чем указанная < новая длина >
, то < строка >
дополняется только частью аргумента < дополняемые символы >
. В этом случае аргумент < дополняемые символы >
усекается справа.
line:="12345"; new_line:=lpad('12345',10,'abcdefgh'); // abcde12345
Возвращаемое значение
-
< Строка >
, дополненная слева указанными последовательностями символов. -
Тип возвращаемого значения совпадает с типом аргумента.
-
Если
< строка >
имеет NULL-значение, возвращается NULL-значение.