|
|
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:
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)
|
Copyright © 2000 BEA Systems, Inc. All rights reserved.
|