AINS( )

Topic group Related Topics

Inserts an element with the value false into a one-dimensional array, or inserts a row or column of elements with the value false into a two-dimensional array. Returns 1 if successful, an error if unsuccessful.

Syntax

AINS(<array name>, <position expN> [, <row/column expN>])

<array name>

The name of a declared one- or two-dimensional array in which to insert data.

<position expN>

When <array name> is a one-dimensional array, <position expN> specifies the number of the element in which to insert a value of false.

When <array name> is a two-dimensional array, <position expN> specifies the number of a row or column in which to insert false values. The third argument (discussed in the next paragraph) specifies whether <position expN> is a row or a column.

<row/column expN>

Either 1 or 2. If you omit this argument or specify 1, a row is inserted into a two-dimensional array. If you specify 2, a column is inserted. dBASE Plus returns an error if you use <row/column expN> with a one-dimensional array.

Description

See the description for insert( ).