Ffinds(), Ffinds32() - return ptr to string representation
Ffinds(FBFR *fbfr, FLDID fieldid, FLDOCC oc)
Ffinds32(FBFR32 *fbfr, FLDID32 fieldid, FLDOCC32 oc)
Ffinds() is provided to handle the case of conversion to a user type of FLD_STRING. fbfr is a pointer to a fielded buffer. fieldid is a field identifier. oc is the occurrence number of the field. The specified field occurrence is found and converted from its type in the buffer to a null-terminated string. Basically, this macro calls its conversion function counterpart, CFfind(), providing a utype of FLD_STRING, and a ulen of 0. The duration of the validity of the pointer returned by Ffinds() is the same as that described for CFfind().
Ffinds32() is used with 32-bit FML.
A thread in a multithreaded application may issue a call to Ffinds() or Ffinds32() while running in any context state, including TPINVALIDCONTEXT.
This function returns NULL on error and sets Ferror to indicate the error condition.
Under the following conditions, Ffinds() fails and sets Ferror to:
The buffer does not begin on the proper boundary.
The buffer is not a fielded buffer or has not been initialized by Finit().
A field occurrence is requested but the specified field and/or occurrence was not found in the fielded buffer.
A field identifier is specified which is not valid.
A field type is specified which is not valid.
Allocation of space dynamically using malloc()failed while converting carray to string.
Introduction to FML Functions, CFfind, CFfind32(3fml), Ffind, Ffind32(3fml)
Copyright © 2000 BEA Systems, Inc. All rights reserved.