# WRITEVU

Updated: 10/19/2021, 9:29:48 PM
Created: 10/19/2021, 9:29:48 PM
Last Updated By: Kevin Munoz
Read Time: 1 minute(s)

# Description

The WRITEVU statement allows a program to write a specific field on a record in a previously opened file. An existing record lock will be preserved. The statement takes the general form:

WRITEVU variable1 ON|TO { variable2,} expression1, expression2 {SETTING setvar} {ON ERROR statements}
1

Where:

variable1 is the identifier holding the record to be written.

variable2, if specified, should be a jBASE BASIC variable that has previously been opened to a file using the OPEN statement. If variable2 is not specified then the default file is assumed.

expression1 should evaluate to a valid record key for the file.

expression2 should evaluate to a positive integer number; if the number is greater than the number of fields in the record, null fields will be added to variable1. If expression2 evaluates to a non-numeric argument, a run time error will be generated.

If the SETTING clause is specified and the write fails, it sets setvar to one of these values.

If the statement fails to write the record, it executes any statements associated with the ON ERROR clause.

Any of the following events will release the lock taken by the WRITEVU statement:

  • The same program with WRITE, WRITEV or MATWRITE statements writes to the record.
  • By explicitly using the RELEASE statement, it releases the record lock.
  • The program stops normally or abnormally.

An example of use is as:

OPEN "Customers" ELSE ABORT 201, "Customers"
OPEN "DICT Customers" TO DCusts ELSE ABORT 201, "DICT Customers"
WRITEVU Rec ON DCusts, 'Xref', 1 SETTING Err ON ERROR
    CRT "I/O Error[" :Err: "]" ABORT
END
1
2
3
4
5

See also: MATWRITEU, RELEASE, WRITE, WRITEU.

Go back to jBASE BASIC

Go back to Programmers' Reference Guide