Синтаксис

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

Возвращаемое значение