PA_MoveBlock

4D - Documentation   Français   English   German   4D Plugin API, Command Theme List   4D Plugin API, Command Alphabetical List   Back   Previous   Next

version 2003


PA_MoveBlock (source; dest; len)

ParameterTypeDescription
sourcevoid *Pointer to a block of memory to copy
destvoid *Address at which to copy it
lenlongNumber of bytes to copy

Description

The routine PA_MoveBlock copies the block of memory pointed to by source to the one pointed to by dest.

This routine is an utility routine, it does not call any entry point of 4th Dimension. As is typical for a copy routine, be sure to check that dest has enough room to receive theSize bytes in order to avoid overlapping.

Warning

Source is first parameter as in BlockMove of Macintosh Toolbox; users of the memcpy ANSI function needs to take this into account..

Examples

All of the following examples assume that the destination string has enough room to receive the source string.

Copy a Pascal string in a C string:

   PA_MoveBlock(&srcePString[1], destCString, srcePString[0]);
   destCString[ srcePString[0] + 1 ] = 0;   // add the null char

See Also

No reference.

Error Handling

PA_GetLastError keeps the last error that occurred before calling PA_MoveBlock.


4D - Documentation   Français   English   German   4D Plugin API, Command Theme List   4D Plugin API, Command Alphabetical List   Back   Previous   Next