std-expt


Synopsis

(std-expt <num> <x>)

Description

Returns numx, the base num raised by the exponent x. The return value is a integer if possible and both arguments were integers or a real number otherwise.

Complex numbers are not supported, so negative base numbers with real exponents are rejected.

Examples

(std-expt 2 0)	=> 1
(std-expt 2.0 0)	=> 1.0
(std-expt 2 1)	=> 2
(std-expt 2.0 1)	=> 2.0
(std-expt 0 1)	=> 0
(std-expt 1 1)	=> 1
(std-expt 2 3)	=> 8.0
(std-expt 2 -1)	=> 0.5
(std-expt 2 -2)	=> 0.25
(std-expt 2 -3)	=> 0.125
(std-expt 2 -3)	=> 0.125
(std-expt 4 0.5)	=> 2.0
(std-expt -2 2)	=> 4
(std-expt -2 3)	=> -8
(std-expt -4 0.5)	=> 'ERROR
(std-expt -2 -3)	=> -0.125
(std-expt -2 -2)	=> 0.25
(std-expt -2 -1)	=> -0.5
(std-expt 2 -200)	=> 6.22302e-061
(std-expt 2 200)	=> 1.60694e+060

Arguments

num: Any number, if integer or real.

x: Any number, if integer or real.

Return Value

Either a real or integer number. Type preserving is attempted.

Side Effects

None.

Module

(std-require 'STDMATH)

Defined in STDMATH