| 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 |