# MATWRITEU

Updated: 11/30/2021, 7:00:45 PM
Created: 11/30/2021, 7:00:45 PM
Last Updated By: Jake Tuttle
Read Time: 1 minute(s)

Tags: dimensioned arrays record locking record handling

# Description

The MATWRITEU statement transfers the entire contents of a dimensioned array to a specified record on file, in the same manner as the MATWRITE statement. An existing record lock will be preserved. It takes the general form:

MATWRITEU array ON { variable,}expression {SETTING setvar} {ON ERROR statements}
1

Where:

  • array should be a previously dimensioned and initialized array. If specified, variable should be a previously opened file variable (i.e. the subject of an OPEN statement). If variable is not specified the default file variable is used.
  • expression should evaluate to the name of the record in the file.
  • If the SETTING clause is specified and the write succeeds, setvar will be set to the number of attributes read into array. If the SETTING clause is specified and the write fails, setvar will be set to one of these values.

If ON ERROR is specified, the statements following the ON ERROR clause will be executed for any of these values except error 128.

The compiler will check that the variable specified is indeed a dimensioned array before its use in the statement.

An example of use is as:

DIM Array(8)
MAT Array = 99
....
MATWRITEU Array ON "NewArray"
1
2
3
4

Go back to jBASE BASIC

Go back to Programmers' Reference Guide