MATWRITE

The MATWRITE statement transfers the entire contents of a dimensioned array to a specified record on disc.

COMMAND SYNTAX

    MATWRITE array TO | ON {variable,} expression { SETTING setvar }  \
           { ON ERROR statements }

SYNTAX ELEMENTS

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 the array.

If the SETTING clause is specified and the write fails, setvar will be set to one of the following values:

INCREMENTAL FILE ERRORS

If ON ERROR is specified, the statements following the ON ERROR clause will be executed for any of the above Incremental File Errors except error 128.

NOTES

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

EXAMPLES

    DIM A(8)
    MAT A = 99
    ....
    MATWRITE A ON "NewArray" SETTING ErrorCode ON ERROR
       CRT "Error: " :ErrorCode: " Record could not be written."
    END
    ...
    MATWRITE A ON RecFile, "OldArray"