[Top] [Prev] [Next] [Bottom]

CFchg (3FML)

CFchg (3FML)

Name

CFchg, CFchg32-convert and change field

Synopsis

#include <stdio.h> 
#include "fml.h" 
int CFchg(FBFR *fbfr, FLDID fieldid, FLDOCC oc, char *value, 
       FLDLEN len, int type) 
#include "fml32.h" 
int CFchg32(FBFR32 *fbfr, FLDID32 fieldid, FLDOCC32 oc, 
       char *value,
FLDLEN32 len, int type)

Description

CFchg() acts like Fchg() but first converts the value from the user-specified type to the type of the fieldid for which the field is changed in the fielded buffer. fbfr is a pointer to a fielded buffer. fieldid is a field identifier. oc is the occurrence number of the field. value is a pointer to a new value. len is the length of the value to be changed; it is required only if type is FLD_CARRAY. type is the data type of value.

If a field occurrence is specified that does not exist, then NULL values are added for the missing occurrences until the desired value can be added (e.g., changing field occurrence 4 for a field that does not exist in a buffer will cause 3 NULL values to be added followed by the specified field value).

CFchg32 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, CFchg() 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().

"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).

"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.

"field not present"
A field occurrence is requested but the specified field and/or occurrence was not found in the fielded buffer.

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

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

See Also

Fintro(3)
CFadd(3)
Fchg(3)

[Top] [Prev] [Next] [Bottom]