|
ANSI Common Lisp 12 Numbers 12.2 Dictionary of Numbers
- Syntax:
-
abs
number
absolute-value
- Arguments and Values:
-
number - a number.
absolute-value - a non-negative real.
- Description:
-
abs returns the absolute value of number.
If number is
a real,
the result is of the same type as number.
If number is a complex,
the result is a positive
real
with
the same magnitude as number.
The result can be a float
even if number's components are rationals
and an exact rational result
would have been possible.
Thus the result of (abs #c(3 4)) can be either 5 or 5.0,
depending on the implementation.
- Examples:
-
(abs 0) 0
(abs 12/13) 12/13
(abs -1.09) 1.09
(abs #c(5.0 -5.0)) 7.071068
(abs #c(5 5)) 7.071068
(abs #c(3/5 4/5)) 1 or approximately 1.0
(eql (abs -0.0) -0.0) true
- See Also:
-
Section 12.1.3.3 Rule of Float Substitutability
- Notes:
-
If number is a complex,
the result is equivalent to the following:
(sqrt (+ (expt (realpart number) 2) (expt (imagpart number) 2)))
An implementation should not use this formula directly
for all complexes
but should handle very large or very small components specially
to avoid intermediate overflow or underflow.
- Allegro CL Implementation Details:
-
None.
|