Função RPAD() no Oracle

No Oracle, o RPAD() A função permite preencher a parte direita 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:

RPAD(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 à direita 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 RPAD('Cat', 25)
FROM DUAL;

Resultado:

              RPAD('CAT',25) 
____________________________ 
Cat

Não é fácil ver o efeito deste exemplo, porque nós preenchemos a string com o caractere padrão (um espaço), mas ele teve o efeito de aumentar a largura da coluna.

Abaixo está outro exemplo que demonstra melhor o efeito:

SELECT RPAD('Cat', 15) || 'House'
FROM DUAL;

Resultado:

   RPAD('CAT',15)||'HOUSE' 
__________________________ 
Cat            House

A concatenação das duas strings revela a quantidade de preenchimento que foi aplicada à parte direita da string mais à esquerda.

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

Especifique um caractere

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

SELECT RPAD('Cat', 7, '!')
FROM DUAL;

Resultado:

   RPAD('CAT',7,'!') 
____________________ 
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 RPAD('Cat', 2)
FROM DUAL;

Resultado:

   RPAD('CAT',2) 
________________ 
Ca

Exemplo de banco de dados

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

SELECT 
    country_name,
    RPAD(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 
    RPAD(null, 3),
    RPAD('Cat', null),
    RPAD('Cat', 3, null)
FROM DUAL;

Resultado:

   RPAD(NULL,3)    RPAD('CAT',NULL)    RPAD('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 RPAD() sem passar nenhum argumento retorna um erro:

SELECT RPAD()
FROM DUAL;

Resultado:

Error starting at line : 1 in command -
SELECT RPAD()
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 RPAD('Cat', 1, '>', 2)
FROM DUAL;

Resultado:

Error starting at line : 1 in command -
SELECT RPAD('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: