Contents|Symbol Index|Up: Chapter 12 Dictionary|Prev: evenp, oddp|Next: gcd

Function `exp, expt`

Syntax:

exp number → result

expt base-number power-number → result

Arguments and Values:

number—a number.

base-number—a number.

power-number—a number.

result—a number.

Description:

exp and expt perform exponentiation.

12.5.1 2exp returns e raised to the power number, where e is the base of the natural logarithms. 12.5.3 9exp has no branch cut.

12.5.0 5 12.5.1 3expt returns base-number raised to the power power-number. If the base-number is a rational and power-number is an integer, the calculation is exact and the result will be of type rational; otherwise a floating-point approximation might result. For expt of a complex rational to an integer power, the calculation must be exact and the result is of type (or rational (complex rational)).

12.5.1 6The result of expt can be a complex, even when neither argument is a complex, if base-number is negative and power-number is not an integer. The result is always the principal complex value. For example, (expt -8 1/3) is not permitted to return -2, even though -2 is one of the cube roots of -8. The principal cube root is a complex approximately equal to #C(1.0 1.73205), not -2.

12.5.3 10expt is defined as $b^{x}$ = $e^{x \log b}$ . Barmar thinks this should just cross-reference the LOG function. (I agree.) -kmp 22-Jan-92 This is defined in LOG. , where \issue{IEEE-ATAN-BRANCH-CUT:SPLIT} \f{(log \i{b}) = (complex (log (abs \i{b})) (phase \i{b}))}. \endissue{IEEE-ATAN-BRANCH-CUT:SPLIT}This defines the principal values precisely. The range of expt is the entire complex plane. Regarded as a function of x, with b fixed, there is no branch cut. Regarded as a function of b, with x fixed, there is in general a branch cut along the negative real axis, continuous with quadrant II. The domain excludes the origin. By definition, $0^{0}$ =1. If b=0 and the real part of x is strictly positive, then $b^{x}$ =0. For all other values of x, $0^{x}$ is an error.

12.5.1 4When power-number is an integer 0, then the result is always the value one in the type of base-number, even if the base-number is zero (of any type). That is:

 (expt x 0) ≡ (coerce 1 (type-of x))

If power-number is a zero of any other type, then the result is also the value one, in the type of the arguments after the application of the contagion rules in Section 12.1.1.2 (Contagion in Numeric Operations), with one exception: the consequences are undefined if base-number is zero when power-number is zero and not of type integer.

Examples:

 (exp 0) → 1.0
 (exp 1) → 2.718282
 (exp (log 5)) → 5.0 
 (expt 2 8) → 256
 (expt 4 .5) → 2.0
 (expt #c(0 1) 2) → -1
 (expt #c(2 2) 3) → #C(-16 16)
 (expt #c(2 2) 4) → -64

Affected By:

None.

Exceptional Situations:

None.

Notes:

12.5.1 5Implementations of expt are permitted to use different algorithms for the cases of a power-number of type rational and a power-number of type float.

Note that by the following logic, (sqrt (expt x 3)) is not equivalent to (expt x 3/2).

!!! Figure out some way to notate these `precise approximations'

 (setq x (exp (/ (* 2 pi #c(0 1)) 3)))         ;exp(2.pi.i/3)
 (expt x 3) → 1 ;except for round-off error
 (sqrt (expt x 3)) → 1 ;except for round-off error
 (expt x 3/2) → -1 ;except for round-off error