PURPOSE

Fojoin, Fojoin32 - outer join source into destination buffer

SYNOPSIS


#include <stdio.h>
#include "fml.h"
int
Fojoin(FBFR *dest, FBFR *src)
#include "fml32.h"
int
Fojoin32(FBFR32 *dest, FBFR32 *src)

DESCRIPTION

Fojoin() is similar to Fjoin(3fml), but it keeps fields from the destination buffer, dest, that have no corresponding fieldid/occurrence in the source buffer, src. Fields that exist in the source buffer that have no corresponding fieldid/occurrence in the destination buffer are not added to the destination buffer.

As with Fjoin(3fml), this function can fail for lack of space; it can be re-issued again after allocating more space to complete the operation.

Fojoin32 is used with 32-bit FML.

RETURN VALUES

This function returns -1 on error and sets Ferror to indicate the error condition.

ERRORS

Under the following conditions, Fojoin() fails and sets Ferror to:

[FALIGNERR]
"fielded buffer not aligned" Either the source buffer or the destination buffer does not begin on the proper boundary.
[FNOTFLD]
"buffer not fielded" Either the source buffer or the destination buffer is not a fielded buffer or has not been initialized by Finit().
[FNOSPACE]
"no space in fielded buffer" A field value is to be added or changed in a field buffer but there is not enough space remaining in the buffer.

EXAMPLE

In the following example,

if(Fojoin(dest,src) < 0)
    F_error("pgm_name");