Texas Instruments TI-89 - Ex_Getarg

1102
Appendix A: System Routines — Utilities
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
EX_getArg
Declaration:
EStackIndex
EX_getArg
(USHORT
j
)
Category(ies):
Utilities
Description:
Retrieves a pointer to the
jth
argument of an ASM program.
ASM programs can be called with arguments from TI
-
BASIC programs and
from the Home screen author line. The arguments are evaluated and
pushed on the estack from left to right. The left-most argument is deepest
on the estack when the ASM program is called.
Inputs:
j
— Argument number to retrieve. 0 retrieves the right-most argument.
Outputs:
Returns pointer to
jth
argument on the estack or NULL if
j
is past end of
argument list.
Assumptions:
None
Side Effects:
None
Availability:
All versions of the TI
-
89 / TI
-
92 Plus.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: next_expression_index
Example:
EStackIndex e;
USHORT j;
.
.
.
/* Process each arg until NULL arg encountered */
for (j = 0; (e = EX_getArg(j)) != NULL; j += 1)
{
processArg(e);
}