Texas Instruments TI-89 - Cmd_Rclgdb

586
Appendix A: System Routines — Graphing
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
cmd_rclgdb
Declaration:
void
cmd_rclgdb
(EStackIndex
name_idx
)
Category(ies):
Graphing, Variables
Description:
Recall a graph database (make it the current graph database) from the
variable indexed by
name_idx
. This is the TI
-
BASIC command RclGDB.
See chapter
14. Data Types
for a description of graph databases.
Inputs:
name_idx
— Indexes the name of the graph database to recall.
Outputs:
None
Assumptions:
None
Side Effects:
May cause heap compression.
Availability:
On AMS 1.05 and higher.
TI-89 / TI-92 Plus
Differences:
None
See Also: cmd_stogdb
Example:
This example saves the current graph database, makes some changes (for
whatever reason), and then finally restores the previous graph database
from the saved one.
EStackIndex oldTop, name_idx;
oldTop = top_estack;
TRY
push_quantum( END_TAG );
if (TokenizeSymName( (BYTE *) "gdb1", 0 ) == NULL)
ER_THROW( INVALID_PATHNAME_ERROR );
name_idx = top_estack;
cmd_stogdb( name_idx );
.
.
.
/* may change some of the graphed functions or graph window information here */
.
.
.
cmd_rclgdb( name_idx );
ONERR
top_estack = oldTop;
ERD_dialog( errCode, FALSE );
return;
ENDTRY
top_estack = oldTop;