Sidebar
endurox:v7.5.x:api:ubf:boccur.3
Name
Boccur — Return number field occurrences (i.e. number of array elements)
Synopsis
#include <ubf.h>
BFLDOCC Boccur (UBFH *p_ub, BFLDID bfldid);
Link with -lubf -lnstd -lm -lpthread
DESCRIPTION
Get the number of field occurrences in buffer. p_ub is pointer to UBF buffer (allocated with tpalloc(3), buffer type "UBF", "FML" or "FML32"). bfldid is UBF buffer field id (which is generated by mkfldhdr(8)).
RETURN VALUE
On success, Boccur() returns number of field occurrences; If field not found, then return is 0; on error, -1 is returned, with Berror set to indicate the error.
ERRORS
Bstrerror(3) can give more description for error (for last call).
BALIGNERR Corrupted buffer or pointing to not aligned memory area.
BNOTFLD Buffer not fielded, not correctly allocated or corrupted. p_ub is NULL.
FBADFLD Invalid field type.