---

Finit (3FML)

Name

Finit, Finit32-initialize fielded buffer

Synopsis

#include <stdio.h>  
#include "fml.h"  
int  
Finit(FBFR *fbfr, FLDLEN buflen)  
#include "fml32.h"  
int  
Finit32(FBFR32 *fbfr, FLDLEN32 buflen)

Description

Finit() can be called to initialize a fielded buffer statically. fbfr is a pointer to a fielded buffer. buflen is the length of the buffer. The function takes the buffer pointer and buffer length, and sets up the internal structure for a buffer with no fields. Finit() can also be used to re-initialize a previously used buffer.

Finit32 is used with 32-bit FML.

Return Values

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

Errors

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

[FALIGNERR]

"fielded buffer not aligned"
The buffer does not begin on the proper boundary.

[FNOTFLD]

"buffer not fielded"
The buffer pointer is NULL.

[FNOSPACE]

"no space in fielded buffer"
The buffer size specified is too small for a fielded buffer.

Example

The correct way to re-initialize a buffer to have no fields is: Finit(fbfr, (FLDLEN)Fsizeof(fbfr));

See Also

Fintro(3), Falloc(3), Fneeded(3), Frealloc(3)

---

---