---

Fcpy (3FML)

Name

Fcpy, Fcpy32-copy source to destination buffer

Synopsis

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

Description

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.

Fcpy32 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, Fcpy() 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 or the destination buffer is not a fielded buffer or has not been initialized by Finit().

[FNOSPACE] "no space in fielded buffer"
The destination buffer is not large enough to hold the source buffer.

See Also

Fintro(3)
Fmove(3)

---

---