TOTVSTEC

Árvore de páginas

Versões comparadas

Versão antiga 1

changes.mady.by.user admin

Gravado em

comparado com

Nova versão 2

changes.mady.by.user Adriana Panseri Santos

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Portuguese

Pagetitle
PADC PADL PADR
PADC PADL PADR

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.

Sintaxe

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

Parâmetros/Elementos
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.
Retorno
    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>.
Observações

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.

Exemplos 
PADC( "Texto", 30 )  // Resultado: "            Texto             "PADL( "Texto", 30 )  // Resultado: "                         Texto"PADR( "Texto", 30 )  // Resultado: "Texto                         "
Abrangência
Advanced Protheus 6.09 , Advanced Protheus 7.10 , Microsiga Protheus 8.11 , Protheus 10
Veja Também
RTrim, AllTrim, LTrim