PAD()
 Insere caracteres de preenchimento em valores caractere, data, e numéricos
------------------------------------------------------------------------------

 Sintaxe

     PADL(<exp>, <nTamanho>, [<cCaracPreench>]) --> cStringPreench
     PADC(<exp>, <nTamanho>, [<cCaracPreench>]) --> cStringPreench
     PADR(<exp>, <nTamanho>, [<cCaracPreench>]) --> cStringPreench

 Argumentos

     <exp> é um valor caractere, data, ou numérico no qual serao
     inseridos caracteres de preenchimento.

     <nTamanho> é o tamanho da cadeia de caracteres a ser retornada.

     <cCaracPreench> é o caractere a ser inserido em <exp>.  Caso nao
     seja especificado, o padrao é o espaço em branco.

 Retorno

     PADC(), PADL(), e PADR() retornam o resultado de <exp> na forma de uma
     cadeia de caracteres preenchida com <cCaracPreench>, para totalizar o
     tamanho especificado por <nTamanho>.

 Descriçao

     PADC(), PADL(), e PADR() sao funçoes de tratamento de caracteres que
     inserem caracteres de preenchimento em valores caractere, data ou
     numéricos a fim de criar uma nova cadeia de caracteres de tamanho
     especificado.  PADC() centraliza <exp>, adicionando caracteres de
     preenchimento à direita e à esquerda; PADL() adiciona caracteres de
     preenchimento à esquerda; e PADR() adiciona caracteres de preenchimento
     à direita.  Caso o tamanho de <exp> exceda o argumento <nTamanho>,
     todas as funçoes PAD() truncam cStringPreench ao <nTamanho>
     especificado.

     PADC(), PADL(), e PADR() sao utilizadas para exibir cadeias de
     caracteres de tamanho variável em uma área de tamanho fixo.  Elas podem
     ser usadas, por exemplo, para assegurar o alinhamento com comandos ??
     consecutivos.  Outra utilizaçao é exibir textos em uma tela de tamanho
     fixo, para certificar-se de que o texto anterior foi completamente
     sobreescrito.

     PADC(), PADL(), e PADR() sao o contrário das funçoes ALLTRIM(),
     LTRIM(), e LTRIM(), as quais eliminam espaçoes em branco à esquerda e à
     direita de cadeias de caracteres.

 Exemplos

     Este exemplo utiliza PADR() para formatar a exibiçao do número de um
     registro em uma linha de status, preenchendo os espaços alocados por
     completo:

     IF EOF()
        @ 23, 45 PADR("EOF/" + LTRIM(STR(LASTREC())), 20)
     ELSEIF BOF()
        @ 23, 45 PADR("BOF/" + LTRIM(STR(LASTREC())), 20)
     ELSE
        @ 23, 45 SAY PADR("Registro " + LTRIM(STR(RECNO()) + "/" + ;
           LTRIM(STR(LASTREC())), 20)
     ENDIF

 Arquivos:  Biblioteca EXTEND.LIB.
 To download this example - click here.

See Also: ALLTRIM() LTRIM() RTRIM()