Reading time: 1 minute
A função aAdd é uma das funções de manipulação de array em ADVPL. Essa função tem por finalidade adicionar um novo elemento no final de um array, aumentando o seu tamanho. O conteúdo do novo elemento será o resultado fornecido pela expressão.
*Caso a expressão não seja especificada, será atribuído o valor NIL ao novo elemento.
Sintaxe:
aAdd( < aDest >, < xExpr > )
Parâmetros:
Retorno:
A função aAdd simplifica alguma situações, por exemplo, nós poderíamos ter a seguinte situação, um array multidimensional conforme o exemplo:
aCarros := { {1,”Onix”},{2,”Palio”}, {3,”Uno”},{4,”Jeep Compass”}}
Com a função aAdd poderíamos simplicar a situação fazendo isso:
aCarros := { } //Aqui definimos o array aCarros
aAdd(aCarros,{1,”Onix”})
aAdd(aCarros,{2,”Palio”})
aAdd(aCarros,{3,”Uno”})
aAdd(aCarros,{4,”Jeep Compass”})
#include 'protheus.ch'
/*{Protheus.doc} User Function faAdd
(Essa função tem por finalidade mostrar a função de Manipulação de Array aAdd em ADVPL)
@type Function
@author Adilio Costa
@since 02/05/2020
@version 1.0
@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:aSize
*/
//Manipulações de Array - aAdd
User Function faAdd()
Local nI
Local cMsg := ""
Local aCarros := {}
//Aqui adicionamos elementos ao array aCarros
aAdd(aCarros,{1,"Onix"})
aAdd(aCarros,{2,"Palio"})
aAdd(aCarros,{3,"Uno"})
aAdd(aCarros,{4,"Jeep Compass"})
For nI:=1 To Len(aCarros)
cMsg += "Carro "+cValToChar(nI)+":"+aCarros[nI][2]
If(nI < Len(aCarros))
cMsg += ","
EndIf
Next nI
MsgAlert(cMsg)
Return
É isso aí, finalizamos aqui o post sobre a função aAdd em ADVPL, caso tenha ficado alguma dúvida deixe seu comentário ou nos envie um email para adiliocosta@protheusadvpl.com.br. Até um próximo post. Grande abraço e fica com Deus.
Link(s) de referência: