Fcpy(), Fcpy32() - copy source to destination buffer
Fcpy(FBFR *dest, FBFR *src)
Fcpy32(FBFR32 *dest, FBFR32 *src)
Fcpy() is used to copy the contents of one fielded buffer to another fielded buffer. dest and src are pointers to the destination and source fielded buffers respectively. Fcpy() expects the destination to be a fielded buffer, and thus can check that it is large enough to accommodate the data from the source buffer.
For values of type FLD_PTR, Fcpy32() copies the buffer pointer. The application programmer must manage the reallocation and freeing of buffers when the associated pointer is copied.
Fcpy32() is used with 32-bit FML.
A thread in a multithreaded application may issue a call to Fcpy() or Fcpy32() while running in any context state, including TPINVALIDCONTEXT.
This function returns -1 on error and sets Ferror to indicate the error condition.
Under the following conditions, Fcpy() 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().
The destination buffer is not large enough to hold the source buffer.
Introduction to FML Functions, Fmove, Fmove32(3fml)
Copyright © 2000 BEA Systems, Inc. All rights reserved.