|
|
|
|
|
|
Fconcat, Fconcat32(3fml)
Name
Fconcat(), Fconcat32() - concatenate source to destination buffer
Synopsis
#include <stdio.h>
#include "fml.h"
int
Fconcat(FBFR *dest, FBFR *src)
#include "fml32.h"
int
Fconcat32(FBFR32 *dest, FBFR32 *src)
Description
Fconcat() adds fields from the source buffer to the fields that already exist in the destination buffer. dest and src are pointers to the destination and source fielded buffers, respectively. Occurrences in the destination buffer, if any, are maintained and new occurrences from the source buffer are added with greater occurrence numbers for the field.
Fconcat32() is used with 32-bit FML.
A thread in a multithreaded application may issue a call to Fconcat() or Fconcat32() while running in any context state, including TPINVALIDCONTEXT.
Return Values
This function returns -1 on error and sets Ferror to indicate the error condition.
Errors
Under the following conditions, Fconcat() fails and sets Ferror to:
Either the source buffer or the destination buffer does not begin on the proper boundary.
Either the source or the destination buffer is not a fielded buffer or has not been initialized by Finit().
A field value is to be added in a fielded buffer but there is not enough space remaining in the buffer.
See Also
Introduction to FML Functions, Fjoin, Fjoin32(3fml), Fupdate, Fupdate32(3fml)
|
|
|
|
|
|
Copyright © 2001 BEA Systems, Inc. All rights reserved.
|