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.
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
| Nome | Tipo | Descrição | Obrigatório | Referência |
| cExp | Caracter | Indica um valor do tipo caractere, data ou numérico no qual serão inseridos caracteres de preenchimento. | X | |
| nTamanho | Numérico | Indica o tamanho da string que retornará. | X | |
| cCaracPreench | Caracter | Indica 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
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas