Tempo de leitura: 2 minutos
A função PadC centraliza o conteúdo de uma variável adicionando caracteres de preenchimento à direita e à esquerda. Ela é a junção de PadR e PadL. Ela é uma das funções de manipulação de string em ADVPL.
Sintaxe:
PadC(xExp,nTam,cChar)
Parâmetro(s):
Retorno:
Observações:
- PadC transforma o valor apontado por xExp em string (igual ao comportamento da função cValToChar), e adiciona o caractere definido em cChar à esquerda e à direita do valor de xExp até que o comprimento especificado em nTam seja atingido;
- Caso o comprimento de xExp convertido para string for maior que o especificado em nTam, a função retornará o conteúdo de xExp truncado, de forma que o seu comprimento final seja igual ao definido em nTam;
- Caso cChar não seja especificado, o padrão é o espaço em branco (” “)
- A função utilizará apenas o primeiro caractere da string apontada por cChar;
- Caso a nTam seja menor ou igual a 0 (zero), a função retornará uma string vazia (“”);
- As funções PadC, PadL e PadR são muito úteis para a apresentação de dados, através de uma string, dentro de uma área de determinado comprimento. Elas são normalmente utilizadas para se obter alinhamento, à esquerda ou à direita, ou para centralizar os dados que serão apresentados pelas funções do ADVPL na tela ou na impressora;
- A função PadC é o inverso da função AllTrim.
Exemplo de PadC em ADVPL:
#include 'protheus.ch'
/*{Protheus.doc} User Function PPadC
(Essa função tem por finalidade mostrar a função de Manipulação de String PadC em ADVPL)
@type Function
@author Adilio Costa
@since 26/11/2023
@version Protheus 12.1.2210
@site https://www.protheusadvpl.com.br
@canal https://www.youtube.com/protheusadvpl
@instagram https://www.instagram.com/protheusadvpl
@Portal ProtheusAdvpl:https://hotmart.com/pt-br/marketplace/produtos/portal-protheusadvpl/O10336806O
@Post:PadC
*/
User Function PPadC()
Local xExp := "ProtheusAdvpl"
Local nTam := 20
Local cChar := "_"
cStr := PadC(xExp,nTam,cChar)
MsgInfo("Nova string após o uso de PadC:"+cStr,"Função PadC")
Return
No código ADVPL acima utilizamos a função PadC para indicar que queremos que adicione à esquerda e a direita do conteúdo de xExp(xExp=”ProtheusAdvpl”) o caractere definido em cChar(cChar=”_”) e no final deixe a string definida em xExp com tamanho 20(nTam=20) onde ao final PadC retornou a nova string como:“___ProtheusAdvpl____”:
É isso aí, finalizamos mais um post aqui no Blog ProtheusAdvpl. Caso tenha ficado alguma dúvida deixe seu comentário ou nos envie um e-mail para adiliocosta@protheusadvpl.com.br, até um próximo post, grande abraço e fica com Deus.
Link(s) de referência(s):
