UniBasic Commands Reference - Rocket Software

OSWRITE
Syntax
OSWRITE expr {ON | TO} filename [ON ERROR statements]
Description
The UniBasic OSWRITE command writes the contents of an expression to a
sequential file.
Note: UniData uses the ASCII 0 character [CHAR(0)] as a string-end delimiter. For
this reason, you cannot use ASCII 0 in any string variable in UniBasic. If UniBasic
reads a string with a CHAR(0) character, and then the character is converted to
CHAR(128), OSWRITE converts CHAR(128) to CHAR(0) when writing a block of
characters.
Parameters
The following table describes each parameter of the syntax.
Parameter Description
1-563 UniBasic Commands Reference
expr Specifies the expression to write to filename.
ON | TO filename Specifies the name of a sequential file to which to write.
ON ERROR statements Specifies statements to execute if the OSWRITE statement fails
with a fatal error because the file is not open, an I/O error occurs,
or UniData cannot find the file.
If you do not specify the ON ERROR clause and a fatal error
occurs, the program terminates.
OSWRITE Parameters