PURPOSE

Fvstof, Fvstof32 - copy from C structure to fielded buffer

SYNOPSIS

#include <stdio.h>
#include "fml.h"
int
Fvstof(FBFR *fbfr, char *cstruct, int mode, char *view)
#include "fml32.h"
int
Fvstof32(FBFR32 *fbfr, char *cstruct, int mode, char *view)

DESCRIPTION

Fvstof() transfers data from a C structure to a fielded buffer. fbfr is a pointer to a fielded buffer. cstruct is a pointer to a C structure. mode specifies the manner in which the transfer is made. view is a pointer to a compiled view description. mode has four possible values: FUPDATE FOJOIN FJOIN FCONCAT The action of these modes are the same as that described in Fupdate(3fml), Fojoin(3fml), Fjoin(3fml), and Fconcat(3fml). One can even think of Fvstof() as the same as these functions, except that where they specify a source buffer, Fvstof() specifies a C structure. Bear in mind that FUPDATE does not move structure elements that have null values.

Fvstof32 is used for views defined with viewc32 or VIEW32 typed buffers for larger views with more fields.

RETURN VALUES

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

ERRORS

Under the following conditions, Fvstof() 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 is not a fielded buffer or has not been initialized by Finit().

 

[FEINVAL]

"invalid argument to function"
One of the arguments to the function invoked was invalid, (for example, specifying a NULL cstruct parameter or an invalid mode to Fvstof)

 

[FNOSPACE]

"no space in fielded buffer"
A field value is to be added or changed in a fielded buffer but there is not enough space remaining in the buffer.

 

[FBADACM]

"ACM contains negative value"
An Associated Count Member should not be a negative value while transferring data from a structure to a fielded buffer.

 

[FMALLOC]

"malloc failed"
Allocation of space dynamically using malloc(3) failed when converting from a carray or string value.

SEE ALSO

Fintro(3fml),
Fconcat(3fml),
Fjoin(3fml),
Fojoin(3fml),
Fupdate(3fml),
Fvftos(3fml)