The LPAD SQL Function in MySQL and MariaDB - Pad string on the left |
|
| | LPAD | Syntax: | LPAD(String, Length, String to append) | | Return value: | CHAR | | Function type: | String function | |
| | The LPAD() function returns "String" with "Length" as the result, with the missing characters being filled with "String to append" on the left.
If "Length" is less than the length of "String", "String" is returned truncated to the "Length". This then corresponds to the function LEFT().
If "String to append" is not specified, the LPAD() function pads with spaces.
Numeric values of "String" or "String to append" are interpreted as character strings.
If "String" or "String to append" is NULL, the LPAD() function returns NULL.
Before MariaDB 10.3.1, the "String to append" parameter was mandatory.
As of MariaDB 10.3.6 with SQL_MODE=Oracle, NULL is returned if the result is empty.
The Oracle mode version of the function can be accessed outside of Oracle mode by using then LPAD_ORACLE() function. | SQL Examples for the LPAD function |
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
| select lpad('Test', 8, 'x');
select lpad('Test', 4, 'x');
select lpad('Test', 2, 'x');
select lpad('Test', 8, '123');
select lpad(456, 8, '123');
select lpad(456, 8, 123);
select hex(lpad('Test', 8));
select lpad('Test', 0, 'x');
select lpad('Test', 8, null);
select lpad(null, 4, 'x');
|
|
| lpad('Test', 8, 'x') |
|---|
| varchar(8) BINARY |
|---|
| xxxxTest |
|
|
| lpad('Test', 4, 'x') |
|---|
| varchar(4) BINARY |
|---|
| Test |
|
|
| lpad('Test', 2, 'x') |
|---|
| varchar(2) BINARY |
|---|
| Te |
|
|
| lpad('Test', 8, '123') |
|---|
| varchar(8) BINARY |
|---|
| 1231Test |
|
|
| lpad(456, 8, '123') |
|---|
| varchar(8) BINARY |
|---|
| 12312456 |
|
|
| lpad(456, 8, 123) |
|---|
| varchar(8) BINARY |
|---|
| 12312456 |
|
|
| hex(lpad('Test', 8)) |
|---|
| varchar(16) BINARY |
|---|
| 2020202054657374 |
|
|
| lpad('Test', 0, 'x') |
|---|
| varchar(0) BINARY |
|---|
| |
|
|
| lpad('Test', 8, null) |
|---|
| varchar(8) BINARY |
|---|
| NULL |
|
|
| lpad(null, 4, 'x') |
|---|
| varchar(4) BINARY |
|---|
| NULL |
|
|
| | The examples were created with the MyWAY SQL manager: | How to use the LPAD() function in MySQL and MariaDB databases | | In MySQL and MariaDB the LPAD() function is used to pad strings to a specific length, by adding a specific character or group of characters to the left (at the beginning) of the string. The function is useful when it is necessary to ensure that a string has a certain length. It is commonly used to format data, align text, or create fixed-length fields in reports or display output. | | Further MySQL und MariaDB SQL String functions | | CHAR | CHAR(Character code, [, Charset]) | | More about CHAR Function |
| | CHR | CHR(Character code) | | More about CHR Function |
| | CONCAT | CONCAT(Strings ('str1','str2', ...)) | | More about CONCAT Function |
| | CONCAT_WS | CONCAT_WS(Separator, Strings ('str1','str2', ...)) | | More about CONCAT_WS Function |
| | ELT | ELT(Index, Strings ('str1','str2', ...)) | | More about ELT Function |
| | EXPORT_SET | EXPORT_SET(Bits, On, Off [, Separator] [, Number of bits]) | | More about EXPORT_SET Function |
| | EXTRACTVALUE | EXTRACTVALUE(XML, XPath) |
| | FIELD | FIELD(Search string, Strings ('str1','str2', ...)) | | More about FIELD Function |
| | FORMAT | FORMAT(Number, Decimals [, Region]) | | More about FORMAT Function |
| | INSERT | INSERT(String, Position, Length, String to insert) | | More about INSERT Function |
| | LCASE | LCASE(String) | | More about LCASE Function |
| | LEFT | LEFT(String, Length) | | More about LEFT Function |
| | LOAD_FILE | LOAD_FILE(File name) |
| | LOWER | LOWER(String) | | More about LOWER Function |
| | LPAD_ORACLE | LPAD_ORACLE(String, Length, String to append) | | More about LPAD_ORACLE Function |
| | LTRIM | LTRIM(String) | | More about LTRIM Function |
| | MAKE_SET | MAKE_SET(Bits, Strings ('str1','str2', ...)) | | More about MAKE_SET Function |
| | MID | MID(String, Position [, Length]) | | More about MID Function |
| | QUOTE | QUOTE(String) | | More about QUOTE Function |
| | REPEAT | REPEAT(String, Number) | | More about REPEAT Function |
| | REPLACE | REPLACE(String, Search, Replace) | | More about REPLACE Function |
| | REVERSE | REVERSE(String) | | More about REVERSE Function |
| | RIGHT | RIGHT(String, Length) | | More about RIGHT Function |
| | RPAD | RPAD(String, Length, String to append) | | More about RPAD Function |
| | RPAD_ORACLE | RPAD_ORACLE(String, Length, String to append) | | More about RPAD_ORACLE Function |
| | RTRIM | RTRIM(String) | | More about RTRIM Function |
| | SOUNDEX | SOUNDEX(String) | | More about SOUNDEX Function |
| | SPACE | SPACE(Number) | | More about SPACE Function |
| | SUBSTR | SUBSTR(String, Position, Length) | | More about SUBSTR Function |
| | SUBSTRING | SUBSTRING(String, Position, Length) | | More about SUBSTRING Function |
| | SUBSTRING_INDEX | SUBSTRING_INDEX(String, Delimiter, Number) | | More about SUBSTRING_INDEX Function |
| | TRIM | TRIM([Type] [, Delete character], , String) | | More about TRIM Function |
| | TRIM_ORACLE | TRIM_ORACLE([Type] [, Delete character], , String) | | More about TRIM_ORACLE Function |
| | UCASE | UCASE(String) | | More about UCASE Function |
| | UPPER | UPPER(String) | | More about UPPER Function |
| | WEIGHT_STRING | WEIGHT_STRING(String [AS Format] [LEVEL Level] [Sorting]) | | More about WEIGHT_STRING Function |
| | ASCII | ASCII(String) | | More about ASCII Function |
| | BIT_LENGTH | BIT_LENGTH(String) | | More about BIT_LENGTH Function |
| | CHAR_LENGTH | CHAR_LENGTH(String) | | More about CHAR_LENGTH Function |
| | CHARACTER_LENGTH | CHARACTER_LENGTH(String) | | More about CHARACTER_LENGTH Function |
| | FIND_IN_SET | FIND_IN_SET(Search string, Set of values) | | More about FIND_IN_SET Function |
| | INSTR | INSTR(String, Search string) | | More about INSTR Function |
| | LENGTH | LENGTH(String) | | More about LENGTH Function |
| | LENGTHB | LENGTHB(String) | | More about LENGTHB Function |
| | LOCATE | LOCATE(Search string, String [, Position]) | | More about LOCATE Function |
| | OCTET_LENGTH | OCTET_LENGTH(String) | | More about OCTET_LENGTH Function |
| | ORD | ORD(String) | | More about ORD Function |
| | POSITION | POSITION(Search string IN String) | | More about POSITION Function |
|
|
| | | More information about the LPAD SQL function: and and |
|
|
|
|
