BEA Logo BEA Tuxedo Release 7.1

  Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy


   Tuxedo Doc Home   |   Reference   |   Topic List   |   Previous   |   Next   |   Contents

   BEA Tuxedo FML Function Reference

Fvnull, Fvnull32(3fml)


Fvnull(), Fvnull32() - check if a structure element is null


#include <stdio.h> 
#include "fml.h"

Fvnull(char *cstruct, char *cname, FLDOCC oc, char *view)

#include "fml32.h"

Fvnull32(char *cstruct, char *cname, FLDOCC32 oc, char *view)


Fvnull() is used to determine if an occurrence of a structure element is null. cstruct is a pointer to a C structure. cname is a pointer to the name of an element within cstruct. oc is the occurrence number of the element. view is a pointer to the name of a compiled view description.

Options of Fvopt() such as do not affect this function.

Fvnull32() is used for views defined with viewc32 or VIEW32 typed buffers for larger views with more fields.

A thread in a multithreaded application may issue a call to Fvnull() or Fvnull32() while running in any context state, including TPINVALIDCONTEXT.

Return Values

Fvnull() returns 1, if the specified cname in a C structure is null and returns 0 if not null. This function returns -1 on error and sets Ferror to indicate the error condition.


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


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


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

See Also

Introduction to FML Functions, Fvopt, Fvopt32(3fml), viewfile(5)