Criando arrays

4D v20 R7

Criando arrays

Cria-se um array com um dos comandos de declaração de array descritos neste capítulo. Esta é a lista de comandos de declaração de arrays:

Comando	Cria ou redimensiona um array de
ARRAY INTEGER	Inteiros 2-bytes
ARRAY LONGINT	Inteiros 4-bytes (*)
ARRAY REAL	Reais
ARRAY TEXT	Textos (até 2 GB de texto por elemento) (**)
_o_ARRAY STRING	Textos (obsoleto) (*)
ARRAY DATE	Datas
ARRAY BOOLEAN	Booleanos
ARRAY PICTURE	Imagens
ARRAY POINTER	Ponteiros

ARRAY OBJECTObjetos de linguagem
ARRAY BLOBBLOBs
ARRAY TIMEHoras[#/table]

Cada comando de declaração de arrays pode criar ou redimensionar arrays de uma ou duas dimensões. para mais informação sobre arrays de duas dimensões, consulte a seção Arrays de duas dimensões.

(*) Não há diferença entre os arrays de tipo e os arrays Alfa. O parâmetro longCadeia do comando _o_ARRAY STRING se ignora. Se recomenda utilizar arrays Texto. O comando _o_ARRAY STRING se conserva por motivos de compatibilidade unicamente.

A linha de código a seguir cria (declara) um array inteiro de 10 elementos:

ARRAY INTEGER(aiUmArray;10)

Logo, o código a seguir redimensiona o mesmo array a 20 elementos:

ARRAY INTEGER(aiUmArray;20)

Finalmente, o código a seguir redimensiona o mesmo array a 0 elementos:

ARRAY INTEGER(aiUmArray;0)

Os elementos em um array se referenciam utilizando chaves ({…}). Utiliza-se um número dentro das chaves para referir-se a um elemento em particular; esse número é chamado de número do elemento. As linhas seguintes colocam cinco nomes em um array chamado atNomes e então os mostra em janelas de alerta:

 ARRAY TEXT(atNomes;5)

 atNomes{1}:="Ricardo"

 atNomes{2}:="Sara"

 atNomes{3}:="Samuel"

 atNomes{4}:="Diego"

 atNomes{5}:="Rafael"

 For($vlElem;1;5)

    ALERT("O elemento #"+String($vlElem)+" é igual a: "+atNomes{$vlElem})

 End for

Note a sintaxe atNomes{$vlElem}. Em vez de especificar um número literal como atNomes{3}, pode-se utilizar uma variável numérica para indicar que elemento de um array está se direcionando.

Usando as iterações das estruturas de loop (ARRAY TO LIST, LIST TO ARRAY ou PLAY), pedaços compactos de códigos podem direcionar todos ou parte dos elementos em um array.

Arrays e outras áreas da linguagem 4D

Existem outros comandos 4D que podem criar e trabalhar com arrays. Mais particularmente:

Para se trabalhar com arrays e seleções de registros, utilize os comandos SELECTION RANGE TO ARRAY, SELECTION TO ARRAY, ARRAY TO SELECTION e DISTINCT VALUES.

Objetos do tipo List box estão baseado em arrays; vários comandos do tema "List box" trabalham com arrays, por exemplo LISTBOX INSERT ROWS.

Pode-se criar gráficos a partir de valores armazenados em tabelas e arrays. Para maiores informações, consulte o comando GRAPH.

Os comandos LIST TO ARRAY e ARRAY TO LIST.

Muitos comandos podem construir arrays em uma chamada, por exemplo: FONT LIST, WINDOW LIST, VOLUME LIST, FOLDER LIST, DOCUMENT LIST, GET SERIAL PORT MAPPING, SAX GET XML ELEMENT etc.

Ver também

_o_ARRAY STRING
ARRAY BLOB
ARRAY BOOLEAN
ARRAY DATE
ARRAY INTEGER
ARRAY LONGINT
ARRAY OBJECT
ARRAY PICTURE
ARRAY POINTER
ARRAY REAL
ARRAY TEXT
ARRAY TIME
Arrays
Arrays de duas dimensões