MathF.Pow(Single, Single) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Returns a specified number raised to the specified power.
public:
static float Pow(float x, float y);
public static float Pow (float x, float y);
static member Pow : single * single -> single
Public Shared Function Pow (x As Single, y As Single) As Single
Parameters
- x
- Single
The base number.
- y
- Single
The specified power.
Returns
x
raised to the power of y
Remarks
The following table indicates the return value when various values or ranges of values are specified for the x
and y
parameters. For more information, see Single.PositiveInfinity, Single.NegativeInfinity, and Single.NaN.
x | y | Return value |
---|---|---|
Any value except NaN |
±0 | 1 |
NaN |
±0 | 1 (NaN on .NET Framework)* |
NaN |
Any value except 0 | NaN * |
±0 | < 0 and an odd integer | NegativeInfinity or PositiveInfinity |
±0 | NegativeInfinity |
PositiveInfinity |
±0 | PositiveInfinity |
+0 |
±0 | > 0 and an odd integer | ±0 |
-1 | NegativeInfinity or PositiveInfinity |
1 |
+1 | Any value except NaN |
1 |
+1 | NaN |
1 (NaN on .NET Framework)* |
Any value except 1 | NaN |
NaN * |
-1 < x < 1 | PositiveInfinity |
+0 |
< -1 or > 1 | PositiveInfinity |
PositiveInfinity |
-1 < x < 1 | NegativeInfinity |
PositiveInfinity |
< -1 or > 1 | NegativeInfinity |
+0 |
PositiveInfinity |
< 0 | +0 |
PositiveInfinity |
> 0 | PositiveInfinity |
NegativeInfinity |
< 0 and finite and odd integer | -0 |
NegativeInfinity |
> 0 and finite and odd integer | NegativeInfinity |
NegativeInfinity |
< 0 and finite and not an odd integer | +0 |
NegativeInfinity |
> 0 and finite and not an odd integer | PositiveInfinity |
±0 | < 0 and finite and not an odd integer | PositiveInfinity |
±0 | > 0 and finite and not an odd integer | +0 |
< 0 but not NegativeInfinity |
Finite non-integer | NaN |
* These rows don't appear in the full set of rules for pow
as defined by the IEEE Standard for Floating-Point Arithmetic. They're included here because .NET disables IEEE 754 floating-point exceptions and thus doesn't differentiate between qNaN
(quiet NaN) and sNaN
(signalling NaN). The IEEE 754 specification allows this exception disablement.
This method calls into the underlying C runtime, and the exact result or valid input range may differ between different operating systems or architectures.