Adds a new field to an FML buffer.
int lrt_Fadd32_fld ( FBFR32 *fbfr, "name=fldname" | "id=idval", "value=fldvalue" [, "len=8"], LRT_END_OF_PARAMS );
fbfr
|
A pointer to the FML or FML32 buffer.
|
fldname
|
Field name.
|
idval
|
Field identifier.
|
fldvalue
|
Value of the new FML field.
|
len
|
Field length.
|
The list of parameters must end with LRT_END_OF_PARAMS.
The lrt_Fadd32_fld function adds a new field to an FML buffer. Either the name of the FML field or its field id must me specified as the second parameter. The value of the new FML fielFML bufferd must be specified in the third parameter. The field length is optional. It only needs to be specified of the type of FML field is CARRAY (binary data). The length of the other field is determined by field type and value.
Important: If the data is CARRAY, then once you save the parameter, the len argument becomes the length of the parameter name, rather than the length of the recorded value. For example, if the parameter is <parm>, then len will be 6.