Sidebar
endurox:v8.0.x:api:ubf:cbchg.3
Name
CBchg — Convert and change (add/update) field occurrance in UBF buffer
Synopsis
#include <ubf.h>
int CBchg (UBFH *p_ub, BFLDID bfldid, BFLDOCC occ, char *buf, BFLDLEN len, int usrtype);
Link with -lubf -lnstd -lm -lpthread
DESCRIPTION
Change (add or update) field in UBF buffer by converting given user type usrtype to buffer field’s type (see BFLD_* types). The UBF buffer pointer is passed by p_ub, field id in bfldid. occ is occurrence to change. The user field value is passed in buf. The len is used only if usrtype is BFLD_CARRAY, for which length cannot be detected from passed data.
If occ is bigger than last existing index+1 in buffer then non existing occurrences (which are not being set by this function) are initialized with defaults. For numeric it is 0, for BFLD_CHAR it is 0x00, for BFLD_STRING it is empty string, for BFLD_CARRAY it is empty byte array (with length 0).
Function operations on field types BFLD_UBF and BFLD_VIEW are not supported. This includes type of bfldid or usrtype having any unsupported field types for this function.
RETURN VALUE
On success, CBchg() return zero; on error, -1 is returned, with Berror set to indicate the error.
ERRORS
Note that Bstrerror() returns generic error message plus custom message with debug info from last function call.
BALIGNERR Corrupted buffer or pointing to not aligned memory area.
BNOTFLD Buffer not fielded, not correctly allocated or corrupted.
BNOSPACE No space in buffer for string data.
BMALLOC Failed to allocate type conversion buffer.
BBADFLD Invalid field id passed.
BEBADOP Operation not supported (e.g. work with BFLD_UBF or BFLD_VIEW type fields).