BEA Logo BEA Tuxedo Release 7.1

  Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy


   Tuxedo Doc Home   |   Reference   |   Topic List   |   Previous   |   Next   |   Contents

   BEA Tuxedo FML Function Reference

Falloc, Falloc32(3fml)


Falloc(), Falloc32() - allocate and initialize fielded buffer


#include <stdio.h> 
#include "fml.h"
#include "fml32.h"
FBFR32 *
Falloc32(FLDOCC32 F, FLDLEN32 V)


Falloc() dynamically allocates space using malloc() for a fielded buffer and calls Finit() to initialize it. The parameters are the number of fields, F, and the number of bytes of value space, V, for all fields that are to be stored in the buffer.

Falloc32() is used for larger buffers with more fields.

A thread in a multithreaded application may issue a call to Falloc() or Falloc32() while running in any context state, including TPINVALIDCONTEXT.

Return Values

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


Under the following conditions, Falloc() fails and sets Ferror to:


"malloc failed"
Allocation of space dynamically using malloc() failed.


"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).

See Also

Introduction to FML Functions, Ffree, Ffree32(3fml), Fielded, Fielded32(3fml), Finit, Finit32(3fml), Fneeded, Fneeded32(3fml), Frealloc, Frealloc32(3fml), Fsizeof, Fsizeof32(3fml), Funused, Funused32(3fml)

malloc(3) in a UNIX system reference manual