BEA Logo BEA Tuxedo Release 8.0

  BEA Home  |  Events  |  Solutions  |  Partners  |  Products  |  Services  |  Download  |  Developer Center  |  WebSUPPORT

 

   Tuxedo Documentation   |   FML Function Reference   |   Local Topics   |   Previous Topic   |   Next Topic   |   Contents

 


Fneeded, Fneeded32(3fml)

Name

Fneeded(), Fneeded32() - compute size needed for buffer

Synopsis

#include <stdio.h> 
#include "fml.h"

long
Fneeded(FLDOCC F, FLDLEN V)

#include "fml32.h"

long
Fneeded32(FLDOCC32 F, FLDLEN32 V)

Description

Fneeded() is used to determine the space that must be allocated for a fielded buffer. The F argument is the number of fields, and the V argument is the space for all field values, in bytes.

Fneeded32() is used with 32-bit FML.

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

Return Values

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

Errors

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

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

See Also

Introduction to FML Functions, Falloc, Falloc32(3fml), Fielded, Fielded32(3fml), Finit, Finit32(3fml), Fsizeof, Fsizeof32(3fml), Funused, Funused32(3fml), Fused, Fused32(3fml)

 

back to top previous page next page