PURPOSE

CFadd, CFadd32 - convert and add field

SYNOPSIS

#include <stdio.h> #include "fml.h" int CFadd(FBFR *fbfr, FLDID fieldid, char *value, FLDLEN len, int type) #include <fml32.h> int CFadd32(FBFR32 *fbfr, FLDID32 fieldid, char *value, FLDLEN32 len, int type)

DESCRIPTION

CFadd() acts like Fadd() but first converts the value from the user-specified type to the type of the fieldid for which the field is added to the fielded buffer. fbfr is a pointer to a fielded buffer. fieldid is a field identifier. value is a pointer to the value to be added. len is the length of the value to be added; it is required only if type is FLD_CARRAY. type is the data type of the field in value.

Before the field is added to the buffer, the type of the data item is converted from type supplied by the user to the type specified in in fieldid. If the source type is FLD_CARRAY (arbitrary character array), the len argument should be set to the length of the array; the length is ignored in all other cases. The value for the field to be converted and added must first be put in a variable, value, since C does not permit constructs such as &12345L.

CFadd32 is used with 32-bit FML.

RETURN VALUES

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

ERRORS

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

 

[FMALLOC]

-- malloc failed
Allocation of space dynamically using malloc(3) failed when converting from a carray to string.

 

[FEINVAL]

-- invalid argument to function
One of the arguments to the function invoked was invalid, (for example, a NULL value parameter was specified).

 

[FNOSPACE]

-- no space in fielded buffer
A field value is to be added or changed in a field buffer but there is not enough space remaining in the buffer.

 

[FBADFLD]

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

 

[FTYPERR]

-- invalid field type
A field identifier is specified which is not valid.

SEE ALSO

Fintro(3fml),
Fadd(3fml)