Tempo de leitura: 2 minutos
A função PadL adiciona caracteres de preenchimento à esquerda do conteúdo de uma variável passada como parâmetro. Ela é uma das funções de manipulação de string em ADVPL.
Sintaxe:
PadL(xExp,nTam,cChar)
Parâmetro(s):
Retorno:
Observações:
- PadL transforma o valor apontado por xExp em string (igual ao comportamento da função cValToChar), e adiciona o caractere definido em cChar à esquerda 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.
Exemplo de PadL em ADVPL:
#include 'protheus.ch'
/*{Protheus.doc} User Function PPadL
(Essa função tem por finalidade mostrar a função de Manipulação de String PadL 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:PadL
*/
User Function PPadL()
Local xExp := "ProtheusAdvpl"
Local nTam := 20
Local cChar := "*"
cStr := PadL(xExp,nTam,cChar)
MsgInfo("Nova string após o uso de PadL:"+cStr,"Função PadL")
Return
No código ADVPL acima utilizamos a função PadL para indicar que queremos que adicione à esquerda 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 PadL 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):
