Protheus :: Programação Básica em Advpl “Combo XXXIII”

Estruturas de Dados usando Arrays:

Podemos dizer que em Advpl os Arrays são tratados como referências ou ponteiros. Eles podem ser utilizados para armazenar estruturas de dados complexas como outros arrays, dados numéricos, strings, objetos e até blocos de codificação.

Arrays como Referência:

Ao declarar um array de nElementos, na verdade, estamos criando duas estruturas de memória. O Advpl cria uma estrutura para conter a própria variável e depois uma seqüência de estruturas para armazenar cada elemento do Array. Imagine uma variável contendo um array como separada dos próprios elementos do array. Pense na variável como se estivesse “apontando” ou “citando” os elementos. Presumindo-se a seguinte declaração:

Local aNomes[4]

Poderíamos afirmar que aNomes refere-se ao primeiro elemento do Array.

Em Advpl podemos fazer com que outra variável Array faça referência ( ou aponte ) para uma outra variável Array. Neste caso elas serão equivalentes.

Ex.:

Local aNomes[4]
Local aVar

aVar := aNomes

Qualquer alteração efetuada nos em aNomes será automaticamente refletida em aVar e vice-e-versa.

Podemos utilizar o operador == para determinar se duas variáveis do tipo Array se referem a um mesmo Array. Este operador não compara os elemento por elemento do Array; em vez disso, ele retorna verdadeiro se elas se referirem à mesma Array; caso contrário, falso. Por Exemplo:

Local aNomes
Local aNomesNovos
Local aVar

aNomes := { “P.A.Cabral” , “Santos Dumont” }
aNomesNovos := { “P.A.Cabral” , “Santos Dumont” }
aVar := aNomes

aVar == aNomes // .T. (apenas porque referem-se ao mesmo ponteiro)
aNomes == aNomesNovos //.F.
aVar == aNomesNovos //.F.

Embora os elementos dos Arrays aNomes e aNomesNovos contenham os mesmos valores, eles são arrays distintas ( cada um ocupando uma referência diferente na memória ) e, por isso, o operador == retorna falso.

Nota: O operador == é uma sobreposição. Se for utilizado com string de caracteres, ele retornará verdadeiro se as duas strings foram exatamente iguais. Se for utilizado com duas variáveis arrays, ele retornará verdadeiro se elas se referirem aos elementos do mesmo array.

Existem duas funções, desenvolvidas em AdvPl, que comparam dois arrays, elemento por elemento, e retorna .T. se forem iguais ou .F. caso contrário.

ArrayCompare() e fCompArray()

Usando o mesmo exemplo acima, se utilizarmos ArrayCompare() ou fCompArray() teremos:

Local aNomes
Local aNomesNovos
Local aVar

aNomes := { “P.A.Cabral” , “Santos Dumont” }
aNomesNovos := { “P.A.Cabral” , “Santos Dumont” }
aVar := aNomes

ArrayCompare( aVar , aNomes ) // .T.
ArrayCompare(aNomes , aNomesNovos ) //.T.

fCompArray( aVar , aNomes ) // .T.
fCompArray (aNomes , aNomesNovos ) //.T.

Neste caso ArrayCompare() e fCompArray() retornarão sempre .T. uma vez que os elementos no Array são iguais.