pow

Calculates x^y.

Special Values
x	y	pow(x, y)	div 0	invalid?
anything	±0.0	1.0	no	no
\|x\| > 1	+∞	+∞	no	no
\|x\| < 1	+∞	+0.0	no	no
\|x\| > 1	-∞	+0.0	no	no
\|x\| < 1	-∞	+∞	no	no
+∞	> 0.0	+∞	no	no
+∞	< 0.0	+0.0	no	no
-∞	odd integer > 0.0	-∞	no	no
-∞	> 0.0, not odd integer	+∞	no	no
-∞	odd integer < 0.0	-0.0	no	no
-∞	< 0.0, not odd integer	+0.0	no	no
±1.0	±∞	-NaN	no	yes
< 0.0	finite, nonintegral	NaN	no	yes
±0.0	odd integer < 0.0	$(PLUSMNINF)	yes	no
±0.0	< 0.0, not odd integer	+∞	yes	no
±0.0	odd integer > 0.0	±0.0	no	no
±0.0	> 0.0, not odd integer	+0.0	no	no

Unqual!F pow(F x, G n)
typeof(Unqual!(F).init * Unqual!(G).init) pow(F x, G n)
real pow(I x, F y)
Unqual!(Largest!(F, G)) pow(F x, G y)
@nogc @trusted pure nothrow
Unqual!(Largest!(F, G))
pow
(
F
G
)
(
F x
,
G y
)
if (
isFloatingPoint!(F) &&
isFloatingPoint!(G)
)

Examples

1 assert(pow(1.0, 2.0) == 1.0);
2 assert(pow(0.0, 0.0) == 1.0);
3 assert(pow(1.5, 10.0).feqrel(57.665) > 16);
4 
5 // special values
6 assert(pow(1.5, real.infinity) == real.infinity);
7 assert(pow(0.5, real.infinity) == 0.0);
8 assert(pow(1.5, -real.infinity) == 0.0);
9 assert(pow(0.5, -real.infinity) == real.infinity);
10 assert(pow(real.infinity, 1.0) == real.infinity);
11 assert(pow(real.infinity, -1.0) == 0.0);
12 assert(pow(-real.infinity, 1.0) == -real.infinity);
13 assert(pow(-real.infinity, 2.0) == real.infinity);
14 assert(pow(-real.infinity, -1.0) == -0.0);
15 assert(pow(-real.infinity, -2.0) == 0.0);
16 assert(pow(1.0, real.infinity) is -real.nan);
17 assert(pow(0.0, -1.0) == real.infinity);
18 assert(pow(real.nan, 0.0) == 1.0);

pow

Examples

Meta

Source