Доступные версии документации

Дополнение строки слева
Синтаксис
 
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-значение.

Заметили ошибку?
Выделите текст и нажмите Ctrl + Enter