ARESIZE( )

Topic group Related Topics

Increases or decreases the size of an array according to the specified dimensions and returns a numeric value representing the number of elements in the modified array.

Syntax

ARESIZE(<array name>, <new rows expN>
[,<new cols expN> [, <retain values expN>]])

<array name>

The name of a declared one- or two-dimensional array whose size you want to increase or decrease.

<new rows expN>

The number of rows the resized array should have. <new rows expN> must always be a positive, nonzero value.

<new cols expN>

The number of columns the resized array should have. <new cols expN> must always be zero or a positive value. If you omit this option, ARESIZE( ) changes the number of rows in the array and leaves the number of columns the same.

<retain values expN>

Determines what happens to the values of the array when rows are added or removed. If you want to specify a value for <retain values expN>, you must also specify a value for <new cols expN>.

Description

See the description for resize( ).