PtrAndHand

Concatenate data to the end of an existing Handle

#include <OSUtils.h> Operating System Utilities

OSErr PtrAndHand(srcPtr, destHandle, size );

Ptr srcPtr ; address of some data to copy

Handle destHandle ; data will be concatenated to this Handle

long size ; amount of data, in bytes, to concatenate

returns memory-related Error Code; 0=no error

PtrAndHand copies a specified amount of data, adding it to the end of the data

in a relocatable block and adjusting the destination Handle's size.

srcPtr is the address of some data to copy.

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 size

bytes of data starting at srcPtr.

size is the length, in bytes, of the data to be concatenated.

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) destHandle was invalid on entry

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

Referenced by (7):