Árvore de páginas

Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

« Anterior Versão 2 Atual »

Função: PADC / PADL / PADR

Inserem caracteres de preenchimento em valores, do tipo caracter, data e numérico, para criar uma nova string de tamanho especificado.
Para isso, cada função tem a seguinte característica:
- PADC() centraliza o conteúdo do parâmetro <cExp> adicionando caracteres de preenchimento à direita e à esquerda.
- PADL() adiciona caracteres de preenchimento à esquerda.
- PADR() adiciona caracteres de preenchimento à direira. Caso o tamanho do parâmetro <cExp> exceda o <nTamanho>, todas as funções PAD() truncam <cCaracPreench> ao <nTamanho> especificado.

PADC / PADL / PADR ( < cExp>, < nTamanho>, [ cCaracPreench] ) --> cRet

NomeTipoDescriçãoObrigatórioReferência
cExpCaracterIndica um valor do tipo caractere, data ou numérico no qual serão inseridos caracteres de preenchimento. X
nTamanhoNuméricoIndica o tamanho da string que retornará. X
cCaracPreenchCaracterIndica o caractere que será inserido no parâmetro . Caso não seja especificado, o padrão é o espaço em branco.
    cRet(caracter)
  • PADC(), PADL() e PADR() retornarão o resultado do parâmetro cExp na forma de uma string preenchida com <cCaracPreench> para totalizar o tamanho especificado no <nTamanho>.

Estas funções são utilizadas para exibir strings de tamanho variável em uma área de tamanho fixo.

Pode-se utilizar, por exemplo, essas funções para:

  • Assegurar o alinhamento com comandos consecutivos.
  • Exibir textos em uma tela de tamanho fixo para certificar-se de que o texto anterior foi completamente sobrescrito.

As funções PADC(), PADL() e PADR() são o inverso das AllTrim(), LTrim() e RTrim() que eliminam espaços em branco à direita e à esquerda da string.

PADC( "Texto", 30 )  // Resultado: "            Texto             "PADL( "Texto", 30 )  // Resultado: "                         Texto"PADR( "Texto", 30 )  // Resultado: "Texto                         "
Advanced Protheus 6.09 , Advanced Protheus 7.10 , Microsiga Protheus 8.11 , Protheus 10

  • Sem rótulos