|
|
Funused, Funused32(3fml)
Name
Funused(), Funused32() - return number of unused bytes in fielded buffer
Synopsis
#include <stdio.h>
#include "fml.h"
long
Funused(FBFR *fbfr)
#include "fml32.h"
long
Funused32(FBFR32 *fbfr)
Description
Funused() returns the amount of space currently unused in the buffer. Space is unused if it contains neither user data nor overhead data such as the header and index.
fbfr is a pointer to a fielded buffer.
Funused32() is used with 32-bit FML.
A thread in a multithreaded application may issue a call to Funused() or Funused32() 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, Funused() fails and sets Ferror to:
The buffer does not begin on the proper boundary.
The buffer is not a fielded buffer or has not been initialized by Finit().
See Also
Introduction to FML Functions, Fidxused, Fidxused32(3fml), Fused, Fused32(3fml)
|
Copyright © 2000 BEA Systems, Inc. All rights reserved.
|