Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy
	http://www.oracle.com/technology/documentation/index.html   |   Site Map   |   Search   |   PDF Files   |   Contact   |   Glossary
Tuxedo Doc Home   |   Reference   |   Topic List   |   Previous   |   Next   |   Contents

   BEA Tuxedo FML Function Reference

Frealloc(), Frealloc32() - re-allocate fielded buffer

#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)

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.

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.

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() failed.

Introduction to FML Functions, Falloc, Falloc32(3fml), Ffree, Ffree32(3fml)