Histórico da Página

Sintaxe

ASIZE( <array>, <expressão numérica> )

Propósito

Altera o tamanho de um array já existente, aumentando-o ou diminuindo-o.

Argumentos

< array >

Define o nome do array cujo tamanho será alterado.

< expressão numérica >

Define o novo tamanho do array.

Utilização

A função ASIZE() altera o tamanho do array especificado. O array será aumentado ou diminuído para atingir o tamanho especificado pela expressão numérica.

Se o array for diminuído, os últimos elementos serão descartados. Se o array for aumentado, os novos elementos serão adicionados no final e conterão o valor NIL.

Dicas

A função ASIZE() é similar à função AADD(), que adiciona apenas um elemento no fim de um array e, opcionalmente, pode atribuir um valor ao novo elemento. As funções ASIZE() e AADD() alteram o tamanho de um array e, por esse motivo, diferem significativamente das funções AINS() e ADEL(), que o mantém constante.

Exemplos

Estes exemplos demonstram a adição de novos elementos e a eliminação de elementos existentes:

LOCAL aArray := { 1 }       // Resulta: { 1 }

ASIZE(aArray, 3)               // Resulta: { 1, NIL, NIL }

ASIZE(aArray, 1)               // Resulta: { 1 }