PURPOSE

Fprint, Fprint32 - print buffer to standard output

SYNOPSIS

#include <stdio.h>
#include "fml.h"
int
Fprint(FBFR *fbfr)
#include "fml32.h"
int
Fprint32(FBFR32 *fbfr)

DESCRIPTION

Fprint() prints the specified buffer to the standard output. fbfr is a pointer to a fielded buffer. For each field in the buffer, the output prints the field name and field value separated by a tab. Fname(3fml) 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.

Fprint32 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, Fprint() 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.

SEE ALSO

Fintro(3fml),
Fextread(3fml),
Fname(3fml),
Ffprint(3fml)