PadL

Tempo de leitura: 2 minutos

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