LPAD: Como Preencher uma String de Caracteres à Esquerda

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

Sintaxe: Como Preencher uma String de Caracteres à Esquerda

LPAD(string, out_length, pad_character)

onde:

string

Comprimento alfanumérico fixo

É uma string para preenchimento no lado esquerdo.

out_length

Inteiro

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

pad_character

Comprimento alfanumérico fixo

É um caractere simples utilizado para preenchimento.

Topo da página

Exemplo: Como Preencher uma String à Esquerda

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

DEFINE FILE WF_RETAIL
LPAD1/A25 = LPAD(PRODUCT_CATEGORY,25,'@');
DIG1/A4 = DIGITS(ID_PRODUCT,4);
END
TABLE FILE WF_RETAIL
SUM DIG1 LPAD1
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 LPAD

Para utilizar a aspa simples como o caractere de preenchimento, deve-se dobrá-la e colocá-las entre duas aspas simples (LPAD(COUNTRY, 20,''''). É possível utilizar uma variável ampersand entre aspas para este parâmetro, mas não pode-se usar um campo, virtual ou real.
A entrada pode ter comprimento alfanumérico fixo ou variável.
A saída, quando otimizada para SQL, sempre terá o tipo de dados VARCHAR.
Se a saída for especificada como mais curta que a entrada original, os dados originais serão truncados, deixando apenas os caracteres de preenchimento. O comprimento de saída pode ser especificado como um inteiro positivo ou uma variável ampersand sem aspas (indicando um numérico).