Sumário

Search

  1. Prefácio
  2. A Linguagem de Transformação
  3. Constantes
  4. Operadores
  5. Variáveis
  6. Datas
  7. Funções
  8. Criação de funções personalizadas
  9. Referência de API da Função Personalizada

Referência de Linguagem de Transformação

Referência de Linguagem de Transformação

RPAD

RPAD

Converte uma string em um tamanho especificado ao adicionar espaços em branco ou caracteres ao final da string.

Sintaxe

RPAD(
first_string
,
length
[,
second_string
] )
A tabela a seguir descreve os argumentos para este comando:
Argumento
Requerido/
Opcional
Descrição
first_string
Requerido
Qualquer valor de string. As strings que você deseja alterar. Você pode inserir qualquer expressão de transformação válida.
length
Requerido
Deve ser um número literal inteiro positivo. Especifica o tamanho que você deseja que cada string tenha.
second_string
Opcional
Qualquer valor de string. Passa a string que você deseja anexar ao lado direito dos valores
first_string
. Anexe os caracteres que você deseja adicionar ao final da string entre aspas simples, por exemplo, 'abc'. Esse argumento faz distinção entre maiúsculas e minúsculas.
Se você omitir a segunda string, a função preencherá o final da primeira string com espaços em branco.

Valor de Retorno

String do tamanho especificado.
NULL se um valor passado para a função for NULL ou se o tamanho for um número negativo.

Exemplos

A expressão a seguir retorna o nome de item com um tamanho de 16 caracteres, anexando a string '.' ao final de cada nome de item:
RPAD( ITEM_NAME, 16, '.')
ITEM_NAME
RETURN VALUE
Flashlight
Flashlight......
Compass
Compass.........
Regulator System
Regulator System
Safety Knife
Safety Knife....
RPAD conta o tamanho da esquerda para a direita. Então, se a primeira string for maior que o tamanho, RPAD truncará a string da direita para a esquerda. Por exemplo, RPAD(‘alphabetical’, 5, ‘x’) retornará a string ‘alpha’. RPAD usa uma parte parcial da
second_string
quando necessário.
A expressão a seguir retorna o nome de item com um tamanho de 16 caracteres, anexando a string ‘*.*’ ao final de cada nome de item:
RPAD( ITEM_NAME, 16, '*..*' )
ITEM_NAME
RETURN VALUE
Flashlight
Flashlight*..**.
Compass
Compass*..**..**
Regulator System
Regulator System
Safety Knife
Safety Knife*..*