PURPOSE

Fvselinit, Fvselinit32 - initialize structure element to null

SYNOPSIS

#include <stdio.h>
#include "fml.h"
int
Fvselinit(char *cstruct, char *cname, char *view)
#include "fml32.h"
int
Fvselinit32(char *cstruct, char *cname, char *view)

DESCRIPTION

Fvselinit() initializes an individual element of a C structure to its appropriate null value. cstruct is a pointer to a C structure. cname is a pointer to the name of an element of cstruct. view is a pointer to the name of a compiled view description.

Fvselinit() sets the associated count member of the element to 0 if the C flag was used when the view was compiled, and sets the associated length member to the length of the associated null value if the L flag was used in the view file.

Fvselinit32 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, Fvselinit() fails and sets Ferror to:

[FEINVAL]

"invalid argument to function"
One of the arguments to the function invoked was invalid, (for example, specifying a NULL cstruct parameter invalid Fvselinit).

 

[FBADVIEW]

"cannot find or get view"
The view description specified was NULL or was not found in the files specified by VIEWDIR or VIEWFILES.

 

[FNOCNAME]

"cname not found"
The C structure field name is not found in the view description.

SEE ALSO

Fintro(3fml),
Fvsinit(3fml),
viewfile(5)