BLEN(3)


Table of Contents

1. NAME
2. SYNOPSIS
3. DESCRIPTION
4. RETURN VALUE
5. ERRORS
6. EXAMPLE
7. BUGS
8. SEE ALSO
9. COPYING

1. NAME

Blen - Return field length

2. SYNOPSIS

#include <ubf.h>

int Blen (UBFH *p_ub, BFLDID bfldid, BFLDOCC occ);

Link with -lubf -lnstd -lm -lpthread

3. DESCRIPTION

Return the field length in bytes for given field at given occurrence. 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)), occ is field occurrence in buffer.

4. RETURN VALUE

On success, Blen() returns field length in bytes; on error, -1 is returned, with Berror set to indicate the error.

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

BBADFLD Invalid field id passed.

BNOTPRES Field not present.

6. EXAMPLE

See ubftest/ubfunit1.c for sample code.

7. BUGS

Report bugs to support@mavimax.com

8. SEE ALSO

Badd(3) Bfind(3)

9. COPYING

© Mavimax, Ltd