HandAndHand

Concatenate data from one Handle to an other

#include <OSUtils.h> Operating System Utilities

OSErr HandAndHand(srcHandle, destHandle );

Handle srcHandle ; leads to data to be copied

Handle destHandle ; data will be concatenated to this Handle

returns memory-related Error Code; 0=no error

HandAndHand copies all the data in one relocatable block, adding it to the end

of another and adjusting the destination Handle's size.

srcHandle is a Handle leading to data to be copied.

destHandle is a Handle leading to an existing data area. Upon return, the data

area will contain its original contents, followed by a copy of the

contents of srcHandle.

Returns: an OSErr; an integer Error Code. It will be one of:

noErr (0) No error

memFullErr (-108) Not enough room in heap

nilHandleErr (-109) Invalid Handle

memWZErr (-111) Attempt to operate on a free block

Notes: HandAndHand de references srcHandle internally; thus, you should lock it

before making the call; e.g:

if( HandAndHand( srcHandl, destHandle) ) {

/*... an error occurred ... */

}

HUnlock( srcHandle );

Referenced by (5):