All Databases Inside Mac - Basic Toolbox

SetString

Copy string data to storage on the heap

#include <ToolUtils.h> Toolbox Utilities

void SetString(st rHandle, theString );

StringHandle strHandle ; pre- allocated handle

Str255 theString ; Pascal string to copy

SetString copies a string into relocatable storage in the heap, and sets a

string handle to point to the duplicate.

st rHandle is an existing handle leading to a Pascal-style string. See

NewString. Any existing data in this handle gets overwritten.

theString is the address of a Pascal string. Its data is duplicated by this

operation.

Notes: For C-style, NULL-terminated strings, it is probably preferable to use

PtrToXHand to copy string data to a pre- existing handle or PtrToHand

to create a handle and its storage, and duplicate the string.

Referenced by (7):