|
|
Falloc, Falloc32(3fml)
Name
Falloc(), Falloc32() - allocate and initialize fielded buffer
Synopsis
#include <stdio.h>
#include "fml.h"
FBFR *
Falloc(FLDOCC F, FLDLEN V)
#include "fml32.h"
FBFR32 *
Falloc32(FLDOCC32 F, FLDLEN32 V)
Description
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.
Errors
Under the following conditions, Falloc() fails and sets Ferror to:
Allocation of space dynamically using malloc() failed.
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
|
Copyright © 2000 BEA Systems, Inc. All rights reserved.
|