RPAD: Como Preencher uma String de Caracteres à Direita

RPAD utiliza um caractere e o comprimento da saída especificados para exibir uma string de caracteres preenchida à direita com aquele caractere.

Sintaxe: Como Preencher uma String de Caracteres à Direita

RPAD(string, out_length, pad_character)

onde:

string

Alfanumérico

É uma string para preenchimento no lado direito.

out_length

Inteiro

É o comprimento da string de saída após o preenchimento.

pad_character

Alfanumérico

É um caractere simples utilizado para preenchimento.

Topo da página

Exemplo: Como Preencher uma String à Direita

Na solicitação a seguir na fonte de dados WF_REATIL, RPAD preenche a coluna PRODUCT_CATEGORY à direita com símbolos @:

DEFINE FILE WF_RETAIL
RPAD1/A25 = RPAD(PRODUCT_CATEGORY,25,'@');
DIG1/A4 = DIGITS(ID_PRODUCT,4);
END
TABLE FILE WF_RETAIL
SUM DIG1 RPAD1
BY PRODUCT_CATEGORY
ON TABLE SET PAGE NOPAGE
ON TABLE SET STYLE *
TYPE=DATA,FONT=COURIER,SIZE=11,COLOR=BLUE,$
END

A saída é:

Referência: Observações sobre o Uso para RPAD

A string de entrada pode ser do tipo de dados AnV, VARCHAR, TX e An.
A saída pode ser apenas AnV ou An.
Ao se trabalhar com colunas VARCHAR relacionais, não há a necessidade de se cortar os espaços em branco à direita do campo caso estes não sejam desejados. No entanto, com os campos An e AnV derivados de campos An, os espaços à direita são parte dos dados e serão incluídos na saída, com o preenchimento sendo posicionado à direita destas posições. É possível utilizar TRIM ou TRIMV para remover estes espaços à direita antes de se aplicar a função RPAD.