IOS Instituto de ADVPL I - Vetores/Matrizes (Arrays) -

Oportunidade Social Aula 10

1
 Arrays

Arrays ou matrizes, so colees de valores, semelhantes a uma lista.

Uma matriz pode ser criada atravs de diferentes maneiras.

Cada item em um array referenciado pela indicao de sua posio

numrica na lista, iniciando pelo nmero 1.

O exemplo a seguir declara uma varivel, atribui um array de trs

elementos, e ento exibe um dos elementos e o tamanho do array:

Local aLetras // Declarao da varivel

aLetras := {"A", "B", "C"} // Atribuio do array a varivel
Alert(aLetras[2]) // Exibe o segundo elemento do array
Alert(cValToChar(Len(aLetras))) // Exibe o tamanho do array
2
 Arrays

O ADVPL permite a manipulao de arrays facilmente. Enquanto

que em outras linguagens como C ou Pascal necessrio alocar
memria para cada elemento de um array (o que tornaria a
utilizao de "ponteiros" necessria), o ADVPL se encarrega de
gerenciar a memria e torna simples adicionar elementos a um
array, utilizando a funo AADD():

AADD(aLetras,"D") // Inclui o quarto elemento ao final do array

Alert(aLetras[4]) // Exibe o quarto elemento
Alert(aLetras[5]) // Erro! No h um quinto elemento no array

3
 Arrays como Estruturas

Uma caracterstica interessante do ADVPL que um array pode conter

qualquer tipo de dado: nmeros, datas, lgicos, caracteres, objetos, etc., e
ao mesmo tempo. Em outras palavras, os elementos de um array no
precisam ser necessariamente do mesmo tipo de dado, em contraste com
outras linguagens como C e Pascal.

aFunct1 := {"Pedro",32,.T.}

Este array contem uma string, um nmero e um valor lgico. Em outras

linguagens como C ou Pascal, este "pacote" de informaes pode ser
chamado como um "struct" (estrutura em C, por exemplo) ou um "record"
(registro em Pascal, por exemplo). Como se fosse na verdade um registro de
um banco de dados, um pacote de informaes construdo com diversos
campos. Cada campo tendo um pedao diferente de dado.
4
Arrays como Estruturas

Suponha que no exemplo anterior, o array aFunct1

contenha informaes sobre o nome de uma pessoa, sua
idade e sua situao matrimonial. Os seguintes #defines
podem ser criados para indicar cada posio dos valores
dentro de um array:

#define FUNCT_NOME 1
#define FUNCT_IDADE 2
#define FUNCT_CASADO 3

5
 Arrays como Estruturas

E considere mais alguns arrays para representar mais

pessoas:

aFunct2 := {"Maria" , 22, .T.}

aFunct3 := {"Antnio", 42, .F.}

Os nomes podem ser impressos assim:

Alert(aFunct1[FUNCT_NOME])
Alert(aFunct2[FUNCT_NOME])
Alert(aFunct3[FUNCT_NOME])
6
 Arrays como Estruturas

Agora, ao invs de trabalhar com variveis individuais, pode-se

agrup-las em um outro array, do mesmo modo que muitos
registros so agrupados em uma tabela de banco de dados:

aFuncts := {aFunct1, aFunct2, aFunct3}

Que equivalente a isso:

aFuncts := { {"Pedro" , 32, .T.}, ;

{"Maria" , 22, .T.}, ;
{"Antnio", 42, .F.} }

7
 Arrays como Estruturas

aFuncts um array com 3 linhas por 3 colunas. Uma vez que as variveis
separadas foram combinadas em um array, os nomes podem ser exibidos
assim:

Local nCount
For nCount := 1 To Len(aFuncts)
Alert(aFuncts[nCount, FUNCT_NOME])
// O acesso a elementos de um array multidimensional
// pode ser realizado tambm desta forma:
// aFuncts[nCount][FUNCT_NOME]
Next nCount

A varivel nCount seleciona que funcionrio (ou linha) de interesse.

Ento a constante FUNCT_NOME seleciona a primeira coluna daquela
linha.
8
 Cuidados com Arrays

Arrays so listas de elementos, portanto memria necessria para

armazenar estas informaes. Como estes arrays podem ser
multidimensionais, a memria necessria ser a multiplicao do
nmero de itens em cada dimenso do array, considerando-se o
tamanho do contedo de cada elemento contido nesta. Portanto o
tamanho de um array pode variar muito.

A facilidade da utilizao de arrays, mesmo que para armazenar

informaes em pacotes como descrito anteriormente, no
compensada pela utilizao em memria quando o nmero de itens
em um array for muito grande. Quando o nmero de elementos for
muito grande deve-se procurar outras solues, como a utilizao de
um arquivo de banco de dados temporrio.
9
 Inicializando Arrays

Algumas vezes o tamanho da matriz conhecido previamente. Outras vezes

o tamanho do array somente ser conhecido em tempo de execuo.

Se o tamanho do array conhecido no momento que o programa escrito,

h diversas maneiras de implementar o cdigo:

01 Local nCnt
02 Local aX[10]
03 Local aY := Array(10)
04 Local aZ := {0,0,0,0,0,0,0,0,0,0}
05
06 For nCnt := 1 To 10
07 aX[nCnt] := nCnt * nCnt
08 Next nCnt
10
 Inicializando Arrays

Este cdigo preenche o array com uma tabela de quadrados. Os

valores sero 1, 4, 9, 16 ... 81, 100. Note que a linha 07 se refere
varivel aX, mas poderia tambm trabalhar com aY ou aZ.

O objetivo deste exemplo demonstrar trs modos de criar um array

de tamanho conhecido no momento da criao do cdigo.

1. Na linha 02 o array criada usando aX[10]. Isto indica ao ADVPL

para alocar espao para 10 elementos no array. Os colchetes [ e ] so
utilizados para indicar o tamanho necessrio.

11
 Inicializando Arrays

2. Na linha 03 utilizada a funo array com o parmetro 10 para criar o

array, e o retorno desta funo atribudo varivel aY. Na linha 03
efetuado o que se chama "desenhar a imagem do array". Como se pode
notar, existem dez 0s na lista encerrada entre chaves ({}). Claramente,
este mtodo no o utilizado para criar uma matriz de 1000 elementos.

3. O terceiro mtodo difere dos anteriores porque inicializa a matriz com

os valores definitivos. Nos dois primeiros mtodos, cada posio da
matriz contm um valor nulo (NIL) e deve ser inicializado
posteriormente.

4. A linha 07 demonstra como um valor pode ser atribudo para uma

posio existente em uma matriz especificando o ndice entre colchetes.

12
 Inicializando Arrays

Se o tamanho do array no conhecido Se o tamanho do array no

conhecido at o momento da execuo do programa, h algumas
maneiras de criar um array e adicionar elementos a ele. O exemplo a
seguir ilustra a idia de criao de um array vazio (sem nenhum
elemento) e adio de elementos dinamicamente.

01 Local nCnt
02 Local aX[0]
03 Local aY := Array(0)
04 Local aZ := {}
05
06 For nCnt := 1 To nSize
07 AADD(aX, nCnt*nCnt)
08 Next nCnt
13
Exerccios

1) Criar um Array de 3 posies, atribuir um contedo padro e

exibir os valores das 3 posies em tela
2) Criar um Array 3x3 com a funo ARRAY(), atribuir valores diretos
(nome, idade, sexo) nas posies e mostrar contedo em tela
3) Criar um array com 3 posies numricas, ordenar sem utilizar a
funo aSort e mostrar na tela ordenado
4) Criar um Array com 5 funcionrios que contenha (nome, idade e
sexo), mostrar os dados da ultima posio do Array e exibir os
dados desse funcionrio
5) Criar um Array com 3 funcionrios, sendo que cada funcionrio
ter 2 dependentes, usar a funo AADD() para adicionar os
valores e exibir em tela os dados de cada funcionrio e seus
dependentes (cada funcionrio/ dependente ter as informaes
de nome, idade e sexo)

14
Dvidas ?

Rafael Duram Santos

rafael.duram@totvs.com.br

15