Legacy Document

Inside Macintosh: Text /

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