Tempo de leitura: 1 minuto
A função Right retorna um determinado número da caracteres à direita 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;
- Caso o parâmetro nNumCar seja menor que 0 (zero), a função retornará um erro ADVPL com a mensagem “invalid len on right“.
Exemplo de Right em ADVPL:
#include 'protheus.ch'
/*{Protheus.doc} User Function PRight
(Essa função tem por finalidade mostrar a função de Manipulação de String Right em ADVPL)
@type Function
@author Adilio Costa
@since 27/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:Right
*/
User Function PRight()
Local cTexto := "ProtheusAdvpl"
Local nNumCar := 5
Local cStr := ""
cStr := Right(cTexto,nNumCar)
MsgInfo("Nova string após o uso de Right:"+cStr,"Função Right")
Return
No código ADVPL acima utilizamos a função Right para indicar que queremos que obter 5(nNumCarac=5) à direita do conteúdo de cTexto(cTexto=”ProtheusAdvpl”) onde ao final Right retornou a nova string como:“Advpl”, que representa os últimos 5 caracteres à direita:
É 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):