Math::Pow Method (Double, Double)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Returns a specified number raised to the specified power.

Namespace:   System
Assembly:  mscorlib (in mscorlib.dll)

public:
static double Pow(
	double x,
	double y
)

Parameters

x
Type: System::Double

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

y
Type: System::Double

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

Return Value

Type: System::Double

The number x raised to the power y.

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 Double::PositiveInfinity, Double::NegativeInfinity, and Double::NaN.

Parameters

Return value

x or y = NaN.

NaN

x = Any value except NaN; y = 0.

1

x = NegativeInfinity; y < 0.

0

x = NegativeInfinity; y is a positive odd integer.

NegativeInfinity

x = NegativeInfinity; y is positive but not an odd integer.

PositiveInfinity

x < 0 but not NegativeInfinity; y is not an integer, NegativeInfinity, or PositiveInfinity.

NaN

x = -1; y = NegativeInfinity or PositiveInfinity.

NaN

-1 < x < 1; y = NegativeInfinity.

PositiveInfinity

-1 < x < 1; y = PositiveInfinity.

0

x < -1 or x > 1; y = NegativeInfinity.

0

x < -1 or x > 1; y = PositiveInfinity.

PositiveInfinity

x = 0; y < 0.

PositiveInfinity

x = 0; y > 0.

0

x = 1; y is any value except NaN.

1

x = PositiveInfinity; y < 0.

0

x = PositiveInfinity; y > 0.

PositiveInfinity

The following example uses the Pow method to calculate the value that results from raising 2 to a power ranging from 0 to 32.

No code example is currently available or this language may not be supported.

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show: