Ex_Getbcd - Texas Instruments TI-89 Developer's Manual

Appendix A: System Routines — Utilities

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
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
None
Side Effects:
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 */
TI-89 / TI-92 Plus Developer Guide
— Argument number to retrieve. 0 retrieves the right-most
argument.
Not for Distribution
1103
Beta Version January 26, 2001