Histórico da Página

Sintaxe

ARRAY( <expressão numérica 1>  [ , <expressão numérica 2> ... ] )

Propósito

Cria um novo array, não inicializado, com um determinado tamanho.

Argumentos

< expressões numéricas 1 até n >

Define a quantidade de elementos na dimensão especificada.

Utilização

Se mais de uma expressão numérica for especificada, será criado um array multidimensional através da intercalação de subarrays, com o número de dimensões igual ao número de argumentos especificados.

Dicas

A vantagem da função ARRAY é permitir a criação de arrays dentro de expressões ou blocos de código.

Exemplos

Este exemplo cria um array unidimensional com cinco elementos e posteriormente atribui o valor NIL à cada um deles:

LOCAL aArray := ARRAY(5)

aArray := { NIL, NIL, NIL, NIL, NIL }

Este exemplo cria um array bidimensional com três elementos na primeira dimensão e 2 elementos na segunda dimensão:

aMatriz := ARRAY(3, 2)

Este exemplo ilustra três declarações diferentes que criam o mesmo array multidimensional:

aArray := ARRAY(3, 2)

aArray := { { NIL, NIL }, { NIL, NIL }, { NIL, NIL } }

aArray := { ARRAY(2), ARRAY(2), ARRAY(2) }