Texas Instruments TI-89

Appendix A: System Routines — Strings
975
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
hStrAppend
Declaration:
void
hStrAppend
(HANDLE
hStr1
, UCHAR *
pStr2
)
Category(ies):
Strings
Description:
Append a string to a handle that contains a string.
Inputs:
hStr1
— Handle to string to be lengthened.
Outputs:
pStr2
— String to append to handle.
Assumptions:
None
Side Effects:
May cause heap compression. Throws ER_MEMORY if not enough
memory to expand handle — hStr1.
Availability:
On AMS 2.00 and higher.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also:
None
Example:
This example creates a command string to set the current folder based on
the value selected from a drop-down (OptList[0] index in hOpenFolder).
HANDLE hCurFolderText, hOpenFolder;
WORD OptList[3], DefIndex;
if (!(hOpenFolder = VarCreateFolderPopup(&DefIndex,0)))
ER_throw( ER_MEMORY );
.
.
.
HeapRealloc(hCurFolderText, 20);
memset(HeapDeref(hCurFolderText), 0, 20);
hStrAppend(hCurFolderText, (UCHAR *) XR_stringPtr(XR_setFoldP));
hStrAppend(hCurFolderText, (UCHAR *) PopupText(hOpenFolder,OptList[0]));
hStrAppend(hCurFolderText, (UCHAR *) ")");