|
|
Frealloc, Frealloc32(3fml)
Name
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.
A thread in a multithreaded application may issue a call to Frealloc() or Frealloc32() while running in any context state, including TPINVALIDCONTEXT.
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:
The buffer does not begin on the proper boundary.
The buffer is not a fielded buffer or has not been initialized by Finit().
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).
The new size is smaller than what is currently in the buffer, or allocation of space dynamically using realloc() failed.
See Also
Introduction to FML Functions, Falloc, Falloc32(3fml), Ffree, Ffree32(3fml)
|
Copyright © 2000 BEA Systems, Inc. All rights reserved.
|