Ftypcvt, Ftypcvt32(3fml)

Name

Ftypcvt(), Ftypcvt32() - convert from one field type to another

Synopsis

#include <stdio.h> 
#include "fml.h" 
 
char * 
Ftypcvt(FLDLEN *tolen, int totype, char *fromval, int fromtype, 
  FLDLEN fromlen) 
 
#include "fml32.h" 
 
char * 
Ftypcvt32(FLDLEN32 *tolen, int totype, char *fromval, int fromtype, 
  FLDLEN32 fromlen)

Description

Ftypcvt() converts the value *fromval, which has type fromtype, and length fromlen (if fromtype is FLD_CARRAY; otherwise, fromlen is inferred from fromtype), to a value of type totype. Ftypcvt() returns a pointer to the converted value, and sets *tolen to the converted length, upon success. Upon failure, Ftypcvt() returns NULL.

Ftypcvt32()fails if any of the following field types is used: FLD_PTR, FLD_FML32, or FLD_VIEW32. If one of these field types is encountered, Ferror is set to FEBADOP.

Ftypcvt32() is used with 32-bit FML.

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

Return Values

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

Errors

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

See Also