Histórico da Página
Incluir 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 }