array.variable

array.variable


array references Index Level ASCII
Syntax
Category BASIC
Type Definition
Description references a dimensioned array.
Options
See Also arrays, relational expressions INSERT LOCATE WRITE MATWRITE READ MATREAD DIM ) array array references REPLACE EXTRACT non-fatal error condition dimensioned array INMAT
Example When an "array.variable" is used to describe a dimensioned array, it must be used with a subscript to indicate the specific variable descriptor in the array:

a(10) or a(n)

Otherwise it must be used in a "mat" statement to indicate all elements in the array:

mat a = ''

This sets every variable in the array "a" to null.

matread a from ......

This reads an item and parses the attributes to "a".
Warnings The expression used as a subscript must evaluate to a number. If not, the following runtime warning message is displayed:

[b16] in program "pgm", line n:  Non-numeric data when numeric required; zero used.

The subscript value in a dimensioned array must not be zero or greater, less than or equal to, or greater than the "dim"ed size. If so, the following fatal message is displayed:

[b124] in program "pgm", line n:  Variable 'var' has literal subscripts out of range.

-or-

[b17] in program "pgm", line n: Array subscript out-of-range.
Compatibility D3 7.0 AP R83
array references Index Level ASCII