MathF.Pow(Single, Single) Method

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Source:

MathF.cs

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

Single

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.

See also

• Sqrt(Single)