Appendix A: System Routines — Utilities
1103
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
EX_getBCD
Declaration:
BOOL
EX_getBCD
(USHORT
n
, BCD16 *
bcd
)
Category(ies):
Utilities, Direct Floating Point Operations
Description:
Retrieves
nth
argument of an ASM program as a BCD value.
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:
n
— Argument number to retrieve. 0 retrieves the right-most
argument.
Outputs:
bcd
— Pointer to place where BCD value is returned.
Returns TRUE if
nth
argument exists and is a BCD value, otherwise
FALSE.
Assumptions:
None
Side Effects:
None
Availability:
All versions of the TI
-
89 / TI
-
92 Plus.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: EX_stoBCD
Example:
BCD16 a, b;
.
.
.
/* Get arguments into variables a and b */
if (EX_getBCD(1, &a) && EX_getBCD(0, &b))
{
/* Perform calculation on a and b */
.
.
.
}
else /* Could not retrieve a or b */