Tempo de leitura: 1 minuto
A função aScan percorre um array procurando por um valor especificado. Pode ser especificado um valor a ser buscado, ou pode ser informada uma condição de busca através de um bloco de código. Ela é uma das funções de manipulação de array em ADVPL.
Sintaxe:
aScan(aDestino,xExpr,nInicio,nQtd)
Parâmetro(s):
Retorno:
Exemplo da função aScan em ADVPL:
#include 'protheus.ch'
/*{Protheus.doc} User Function PAaScan
(Essa função tem por finalidade mostrar a função de Manipulação de Array aScan em ADVPL)
@type Function
@author Adilio Costa
@since 12/12/2022
@version Protheus 12.1.2210
@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 do ProtheusAdvpl:
https://hotmart.com/pt-br/club/protheusadvpl
|Se esse conteúdo foi útil pra você nos ajude divulgando
ele e nossas redes sociais!!|
*/
User Function PAaScan()
Local aLingProg := {}
Local nPos
//Adiciona elementos no array aLinProg com a função aAdd
aAdd(aLingProg,"TLPP")
aAdd(aLingProg,"PHP")
aAdd(aLingProg,"JAVA")
aAdd(aLingProg,"C#")
aAdd(aLingProg,"ADVPL")
aAdd(aLingProg,"PYTHON")
nPos := aScan(aLingProg,{|x| AllTrim(x) == "ADVPL"})
If(nPos > 0)
MsgInfo("A linguagem de programação "+aLingProg[nPos]+" foi encontrada na posição:"+cValToChar(nPos),"Função aScan")
EndIf
Return
No código ADVPL acima nós passamos para a função aScan o array aLingProg e uma expressão de busca com o bloco código onde aScan percorre todo o array aLingProg e atribui cada elemento à variável x dentro do bloco de código e assim trazer a posição no array a linguagem “ADVPL“. A função aScan retornou a posição 5 no array:
É 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:
