PURPOSE

Frealloc, Frealloc32 - re-allocate fielded buffer

SYNOPSIS

#include <stdio.h>
#include "fml.h"
FBFR *
Frealloc(FBFR *fbfr, FLDOCC nf, FLDLEN nv)
#include "fml32.h"
FBFR32 *
Frealloc32(FBFR32 *fbfr, FLDOCC32 nf, FLDLEN32 nv)

DESCRIPTION

Frealloc() can be used to re-allocate space to enlarge a fielded buffer. fbfr is a pointer to a fielded buffer. The second and third parameters are the new number of fields, nf, and the new number of bytes value space, nv. These are not increments.

Frealloc32 is used with 32-bit FML.

RETURN VALUES

On success, Frealloc returns a pointer to the re-allocated FBFR.

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

ERRORS

Under the following conditions, Frealloc() 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().

 

[FEINVAL]

"invalid argument to function"
One of the arguments to the function invoked was invalid, (for example, number of fields is less than 0, V is 0 or total size is greater than 65534).

 

[FMALLOC]

"malloc failed"
The new size is smaller than what is currently in the buffer, or allocation of space dynamically using realloc(3) failed.

SEE ALSO

Fintro(3fml),
Falloc(3fml),
Ffree(3fml)