Hstrappend - Texas Instruments TI-89 Developer's Manual

Appendix A: System Routines — Strings

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.
On AMS 2.00 and higher.
Availability:
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 *) ")");
TI-89 / TI-92 Plus Developer Guide Not for Distribution
975
Beta Version January 26, 2001