User Tools

Site Tools


Sidebar

Table Of Contents

endurox:v7.5.x:api:ubf:bjoin.3

Bjoin

Name

Bjoin — join source buffer into destination buffer

Synopsis

#include <ubf.h>

int Bjoin(UBFH *dest, UBFH *src);

Link with -lubf -lnstd -lm -lpthread

DESCRIPTION

Join destination buffer in dest with source buffer src values based on matching fields and occurrence. Function will update existing fields from source buffer to destination with matching occurrences. If field does not exist or occurrence does not exists, then field/occurrence will be removed (doing Bdel(3)).

RETURN VALUE

On success, Bjoin() return zero; 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. dest or src is NULL.

FBADFLD Invalid field type.

EXAMPLE

See ubftest/test_bjoin.c for sample code.

BUGS

Report bugs to support@mavimax.com

COPYING

© Mavimax, Ltd