NAME

writef - write to an opened file



SYNOPSIS

count = writef (buf, n, fd)


character buf(ARB)   or   integer buf(ARB)
integer n
filedes fd
integer count returned as count/ERR




DESCRIPTION

Writef writes "n" bytes from the array "buf" to the file
opened on file descriptor "fd".
Writef is the typical way of doing binary writes to files.
Whether buf is declared an integer or a character array is
dependent upon which is most appropriate for the host operating
system.

Writef returns the number of bytes/words actually written.
In most cases, this is equal to "n".
If, however, a write error occurs, writef returns ERR.


IMPLEMENTATION

Writef is the typical way of implementing binary I/O.
Do whatever is necessary on your system to allow users
to get at the file directly.

If reasonable, design writef to work properly in conjunction
with putch and putlin.


SEE ALSO

readf, putch, putlin


DIAGNOSTICS

None