Left

Tempo de leitura: 1 minuto

A função Left retorna um determinado número da caracteres à esquerda de uma string passada como parâmetro. Ela é uma das funções de manipulação de string em ADVPL. 

 

Sintaxe:

Left(cTexto,nNumCar)

 

Parâmetro(s):

Retorno:

Observações:

  • Caso o parâmetro nNumCar seja maior que o tamanho da string, será retornada a própria string informada no parâmetro;
  • Caso o parâmetro nNumCar seja menor ou igual a 0 (zero), a função retornará uma string vazia.

Exemplo de Left em ADVPL:

#include 'protheus.ch'
/*{Protheus.doc} User Function fLeft
    (Essa função tem por finalidade mostrar a função de Manipulação de String Left em ADVPL)
    @type  Function
    @author Adilio Costa
    @since 27/11/2023
    @version 1.0
@?Inscreva-se no Blog ProtheusAdvpl:
https://www.protheusadvpl.com.br
@?Inscreva-se no Canal ProtheusAdvpl:
https://www.youtube.com/protheusadvpl
@?Siga-nos no Instagram:
https://www.instagram.com/protheusadvpl
@?Conheça os Cursos e Formações do ProtheusAdvpl:
https://cursos-e-formacoes-protheusadvpl.gr-site.com/

|Se esse conteúdo foi útil pra você nos ajude divulgando
ele e nossas redes sociais!!|

*/
User Function fLeft()

	Local cTexto := "ProtheusAdvpl"
    Local nNumCarac := 8
	Local cStr := ""
    
    cStr := Left(cTexto,nNumCarac)

    MsgInfo("Nova string após o uso de Left:"+cStr,"Função Left")

Return

No código ADVPL acima utilizamos a função Left para indicar que queremos que obter 10(nNumCarac=8) à esquerda do conteúdo de cTexto(cTexto=”ProtheusAdvpl”)  onde ao final Left retornou a nova string como:“Protheus”:

Função Left em ADVPL

 

É 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):

 
Receba as últimas atualizações do ProtheusAdvpl
Deixe seu melhor email
Nós respeitamos sua privacidade.