Skip to end of metadata
Go to start of metadata

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 }

 

  • No labels