Edit

MathF.Pow(Single, Single) Method

  • Reference

Definition

Namespace:
System
Assembly:
System.Runtime.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
netstandard.dll
Source:
MathF.cs
Source:
MathF.cs
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

A single-precision floating-point number to be raised to a power.

y
Single

A single-precision floating-point number that specifies a power.

Returns

Single

The number x raised to the power 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.

Applies to

See also