PURPOSE

Fwrite, Fwrite32 - write fielded buffer

SYNOPSIS


#include <stdio.h>
#include "fml.h"
int
Fwrite(FBFR *fbfr, FILE *iop)
#include "fml32.h"
int
Fwrite32(FBFR32 *fbfr, FILE *iop)

DESCRIPTION

Fielded buffers may be written to streams by Fwrite(). (See stdio(3S) in a UNIX System reference manual for a discussion of streams). Fwrite() discards a buffer's index.

fbfr is a pointer to a fielded buffer. iop is a pointer of type FILE to the output stream.

Fwrite32 is used with 32-bit FML.

RETURN VALUES

This function returns -1 on error and sets Ferror to indicate the error condition.

ERRORS

Under the following conditions, Fwrite() fails and sets Ferror to:

[FALIGNERR]
"fielded buffer not aligned"
The buffer does not begin on the proper boundary.
 
[FNOTFLD]
"buffer not fielded"
The buffer is not a fielded buffer or has not been initialized by Finit().
 
[FEUNIX]
"UNIX system call error"
The write system call failed. The external integer errno should have been set to indicate the error by the system call, and the external integer Uunixerr (values defined in Uunix.h) is set to the system call that returned the error.

PORTABILTY

This function is not supported using the TUXEDO System /WS DLL for OS/2 and Microsoft Windows.

SEE ALSO

Fintro(3fml),
stdio(3S) in UNIX System reference manuals,
Findex(3fml),
Fread(3fml)