---

Ffprint (3FML)

Name

Ffprint, Ffprint32-print fielded buffer to specified stream

Synopsis

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

Description

Ffprint is similar to Fprint(3), except the text is printed to a specified output stream. fbfr is a pointer to a fielded buffer. iop is a pointer of type FILE that points to the output stream.

For each field in the buffer, the output prints the field name and field value separated by a tab. Fname(3) is used to determine the field name; if the field name cannot be determined, then the field identifier is printed. Non-printable characters in string and character array field values are represented by a backslash followed by their two-character hexadecimal value. A newline is printed following the output of the printed buffer.

Ffprint32 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, Ffprint() 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().

[FMALLOC]

"malloc failed"
Allocation of space dynamically using malloc(3) failed.

Portability

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

See Also

Fintro(3), Fprint(3)

---

---