Função LPAD() no Oracle

No Oracle, o LPAD() A função permite que você preencher a parte esquerda de uma string com um determinado caractere, para um número especificado de caracteres.

A maneira como funciona é que você especifica quanto tempo a string resultante deve ter. Se a string original for menor, o caractere de preenchimento preenche o espaço restante.

Sintaxe

A sintaxe fica assim:

LPAD(expr1, n [, expr2 ])

Onde:

expr1 e expr2 pode ser qualquer um dos tipos de dados CHAR , VARCHAR2 , NCHAR , NVARCHAR2 , CLOB , ou NCLOB .
n é um NUMBER inteiro ou um valor que pode ser convertido implicitamente em um NUMBER inteiro.

A função retorna expr1 , preenchido à esquerda até o comprimento n caracteres com a sequência de caracteres em expr2 .

Se expr2 for omitido, o caractere de preenchimento é um único espaço em branco.

Exemplo

Aqui está um exemplo simples para demonstrar:

SELECT LPAD('Cat', 5)
FROM DUAL;

Resultado:

   LPAD('CAT',5) 
________________ 
  Cat

Observe que o número fornecido é a largura total da string resultante – não a quantidade de enchimento.

Aqui está novamente quando comparado com a string original (sem preenchimento):

SELECT LPAD('Cat', 5)
FROM DUAL
UNION ALL
SELECT 'Cat'
FROM DUAL;

Resultado:

   LPAD('CAT',5) 
________________ 
  Cat            
Cat

Especifique um caractere

Neste exemplo, especifico um caractere a ser usado para o preenchimento:

SELECT LPAD('Cat', 5, '>')
FROM DUAL;

Resultado:

   LPAD('CAT',5,'>') 
____________________ 
>>Cat

Preenchimento menor que a string original

Se o segundo argumento for menor que a string original, nenhum preenchimento será adicionado e a string original será reduzida para o número de caracteres especificado:

SELECT LPAD('Cat', 2)
FROM DUAL;

Resultado:

   LPAD('CAT',2) 
________________ 
Ca

Exemplo de banco de dados

Aqui está um exemplo de preenchimento da parte esquerda dos valores em uma coluna de banco de dados:

SELECT 
    country_name,
    LPAD(country_name, 12, '.') AS Padded
FROM countries
FETCH FIRST 5 ROWS ONLY;

Resultado:

   COUNTRY_NAME          PADDED 
_______________ _______________ 
Argentina       ...Argentina    
Australia       ...Australia    
Belgium         .....Belgium    
Brazil          ......Brazil    
Canada          ......Canada

Valores nulos

Se algum dos argumentos for null o resultado é null :

SET NULL 'null';

SELECT 
    LPAD(null, 3),
    LPAD('Cat', null),
    LPAD('Cat', 3, null)
FROM DUAL;

Resultado:

   LPAD(NULL,3)    LPAD('CAT',NULL)    LPAD('CAT',3,NULL) 
_______________ ___________________ _____________________ 
null            null                null

Por padrão, SQLcl e SQL*Plus retornam um espaço em branco sempre que null ocorre como resultado de um SQL SELECT demonstração.

No entanto, você pode usar SET NULL para especificar uma string diferente a ser retornada. Aqui eu especifiquei que a string null deve ser devolvido.

Contagem incorreta de argumentos

Chamando LPAD() sem passar nenhum argumento retorna um erro:

SELECT LPAD()
FROM DUAL;

Resultado:

Error starting at line : 1 in command -
SELECT LPAD()
FROM DUAL
Error at Command Line : 1 Column : 8
Error report -
SQL Error: ORA-00938: not enough arguments for function
00938. 00000 -  "not enough arguments for function"
*Cause:    
*Action:

E passar o número errado de argumentos resulta em um erro:

SELECT LPAD('Cat', 1, '>', 2)
FROM DUAL;

Resultado:

Error starting at line : 1 in command -
SELECT LPAD('Cat', 1, '>', 2)
FROM DUAL
Error at Command Line : 1 Column : 28
Error report -
SQL Error: ORA-00939: too many arguments for function
00939. 00000 -  "too many arguments for function"
*Cause:    
*Action: