Дополнение строки слева
Синтаксис
 
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
Возвращаемое значение
  1. < Строка >, дополненная слева указанными последовательностями символов.

  2. Тип возвращаемого значения совпадает с типом аргумента.

  3. Если < строка > имеет NULL-значение, возвращается NULL-значение.