Legacy Document

Important: The information in this document is obsolete and should not be used for new development.

Chapter 5 - Text Utilities / Text Utilities Reference

Routines / Defining and Specifying Strings

SetString
The SetString procedure changes the contents of a string referenced by a string handle, replacing the previous contents by copying the specified string.
PROCEDURE SetString (h: StringHandle; theString: Str255);
h
A handle to the string in memory whose contents you are replacing.
theString
A Pascal string.

DESCRIPTION
The SetString procedure sets the string whose handle is passed in the h parameter to the string specified by the parameter theString. If the new string is larger than the string originally referenced by h, SetString automatically resizes the handle and copies in the contents of the specified string.

SPECIAL CONSIDERATIONS
SetString may move memory; your application should not call this procedure at interrupt time.

ASSEMBLY-LANGUAGE INFORMATION
The trap macro for the SetString procedure is
Trap macro
_SetString