PURPOSE

Funused, Funused32 - return number of unused bytes in fielded buffer

SYNOPSIS

#include <stdio.h>
#include "fml.h"
long
Funused(FBFR *fbfr)
#include "fml32.h"
long
Funused32(FBFR32 *fbfr)

DESCRIPTION

Funused() returns the amount of space currently unused in the buffer. Space is unused if it contains neither user data nor overhead data such as the header and index.

fbfr is a pointer to a fielded buffer.

Funused32 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, Funused() 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().

SEE ALSO

Fintro(3fml),
Fidxused(3fml),
Fused(3fml)