Appendix A: System Routines — EStack Arithmetic
465
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
compare_complex_magnitudes
Declaration:
int
compare_complex_magnitudes
(IndexConstQuantum
j
,
IndexConstQuantum
k
)
Category(ies):
EStack Arithmetic
Description:
Compares the magnitude of the complex number indexed by
j
with the
complex number indexed by
k
.
Inputs:
j, k
— Indexes of tagged real or unreal numbers.
Outputs:
Returns 1 if the complex number indexed by
j
has a greater magnitude
than the complex number indexed by
k
. Returns
L
1 if the complex number
indexed by
j
has a greater magnitude than the complex number indexed
by
k
. Returns 0 if the complex number indexed by
j
has the same
magnitude as the complex number indexed by
k.
Remember that complex
numbers include real numbers. Avoids square roots even if
j
and/or
k
index nonreal numbers.
Assumptions:
j
and
k
point to the tags of tagged real or unreal numbers.
Note that PI_TAG and INFINITY_TAG are not considered numbers here.
Side Effects:
Temporarily attempts to push items onto the estack.
Availability:
On AMS 1.05 and higher.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: compare_numbers, compare_Floats, compare_expressions
Examples:
Boolean has_larger_complex_magnitude (EStackIndex i, EStackIndex j)
{ return compare_complex_magnitudes(j,k) > 0;
}