BEA Logo BEA Tuxedo Release 7.1

  Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy


   Tuxedo Doc Home   |   Reference   |   Topic List   |   Previous   |   Next   |   Contents

   BEA Tuxedo FML Function Reference

Fmove, Fmove32(3fml)


Fmove(), Fmove32() - move fielded buffer to destination


#include <stdio.h> 
#include "fml.h"

Fmove(char *dest, FBFR *src)

#include "fml32.h"

Fmove32(char *dest, FBFR32 *src)


Fmove() should be used when copying from a fielded buffer to any type of buffer. dest and src are pointers to the destination buffer and the source fielded buffers respectively.

The difference between Fmove() and Fcpy() is that Fcpy() expects the destination to be a fielded buffer and thus can make sure it is of sufficient size to accommodate the data from the source buffer. Fmove() makes no such check, blindly moving Fsizeof() bytes of data from the source fielded buffer to the target buffer. The destination buffer must be aligned on a short boundary.

For values of type FLD_PTR, Fmove32() transfers the buffer pointer. The application programmer must manage the reallocation and freeing of buffers when the associated pointer is moved.

Fmove32() is used with 32-bit FML.

A thread in a multithreaded application may issue a call to Fmove() or Fmove32() while running in any context state, including TPINVALIDCONTEXT.

Return Values

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


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


"fielded buffer not aligned"
The source or destination buffer does not begin on the proper boundary.


"buffer not fielded"
The source buffer is not a fielded buffer or has not been initialized by Finit().

See Also

Introduction to FML Functions, Fcpy, Fcpy32(3fml), Fsizeof, Fsizeof32(3fml)