0001 BPROJCPY(3)
0002 ===========
0003 :doctype: manpage
0004
0005
0006 NAME
0007 ----
0008 Bprojcpy - perform projection copy from one buffer to another
0009
0010
0011 SYNOPSIS
0012 --------
0013
0014 #include <ubf.h>
0015
0016 int Bprojcpy (UBFH *'p_ub_dst', UBFH *'p_ub_src', BFLDID *'fldlist');
0017
0018 Link with '-lubf -lnstd -lm -lpthread'
0019
0020 DESCRIPTION
0021 -----------
0022 This function copies fields from 'p_ub_src' to 'p_ub_dst' buffer. The list of field which needs to be copied is marked in 'fldlist' array. The array must be terminated with *BBADFLDID*. Matched field names are copied including all it's occurrences. Before performing copy, 'p_ub_dest' buffer is erased by Binit(3).
0023
0024 RETURN VALUE
0025 ------------
0026 On success, *Bproj()* return zero; on error, -1 is returned, with *Berror* set to indicate the error.
0027
0028 ERRORS
0029 ------
0030 Note that *Bstrerror()* returns generic error message plus custom message with debug info from last function call.
0031
0032 *BALIGNERR* Source or dest buffer corrupted or pointing to not aligned memory area.
0033
0034 *BNOTFLD* Source or dest buffer not fielded, not correctly allocated or corrupted.
0035
0036 *BNOSPACE* No space left in target buffer.
0037
0038 EXAMPLE
0039 -------
0040 See *ubftest/test_bproj.c* for sample code.
0041
0042 BUGS
0043 ----
0044 Report bugs to support@mavimax.com
0045
0046 SEE ALSO
0047 --------
0048 *Bproj(3)* *Binit(3)*
0049
0050 COPYING
0051 -------
0052 (C) Mavimax, Ltd
0053
