UniBasic Commands Reference - Rocket Software

OSBWRITE
Syntax
OSBWRITE expr {ON | TO} file.var [AT byte.expr] [NODELAY] [ON ERROR
statements]
Description
The UniBasic OSBWRITE command writes an expression to a sequential file
starting at a specified byte location. OSBWRITE immediately writes a file segment
out to the UNIX, or Windows platform file.
You do not have to specify a length expression because the number of bytes in expr
is written to the file.
Note: Before you use OSBWRITE, you must open the file by using the OSOPEN or
OPENSEQ command.
UniData uses the ASCII 0 character [CHAR(0)] as a string-end delimiter. Therefore,
ASCII 0 cannot be used in any string variable within UniBasic. If UniBasic reads a
string that contains CHAR(0) characters by using OSBREAD, those characters are
converted to CHAR(128). OSBWRITE converts CHAR(128) back to CHAR(0) when
writing a block of characters.
Writing to Named Pipes
The combination of the following conditions and command options determine the
action taken by UniBasic when OSBWRITE is executed against a named pipe:
Presence and length of data in the pipe
Open/closed status of the pipe
Presence or absence of the AT and NODELAY command options
For information about writing applications that access named pipes, see the Developing
UniBasic Applications manual.
OSBWRITE 1-550