Синтаксис

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

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