Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy
	http://www.oracle.com/technology/documentation/index.html   |   Site Map   |   Search   |   PDF Files   |   Contact   |   Glossary
Tuxedo Doc Home   |   Reference   |   Topic List   |   Previous   |   Next   |   Contents

   BEA Tuxedo FML Function Reference

Fvals(), Fvals32() - return string value of field occurrence

#include <stdio.h> 
#include "fml.h" 
 
char * 
Fvals(FBFR *fbfr, FLDID fieldid, FLDOCC oc) 
 
#include "fml32.h" 
 
char * 
Fvals32(FBFR32 *fbfr, FLDID32 fieldid, FLDOCC32 oc)

Fvals() works like Ffind() for string values but guarantees that a value is returned. fbfr is a pointer to a fielded buffer. fieldid is a field identifier. oc is the occurrence number of the field.

If the specified field occurrence is not found, then the null string is returned. This function is useful for passing the value of a field to another function without checking the return value. This function is valid only for fields of type FLD_STRING; the null string is automatically returned for other field types (that is, no conversion is done).

Fvals32() is used with 32-bit FML.

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

This function returns the null string on error and sets Ferror to indicate the error condition.

Under the following conditions, Fvals() 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().

[FBADFLD]

"unknown field number or type"
A field identifier is specified which is not valid.

[FTYPERR]

"invalid field type"
Bad fieldid or the field type is not FLD_STRING.

Introduction to FML Functions, CFfind, CFfind32(3fml), Ffind, Ffind32(3fml), Fvall, Fvall32(3fml)