Math.Pow(Double, Double) Metoda

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

Math.cs

Vrátí zadané číslo zvýšené na zadanou mocninu.

C#

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

Parametry

x

Double

Číslo s plovoucí desetinou čárkou s dvojitou přesností, které se má zvýšit na mocninu.

y

Double

Číslo s plovoucí desetinou čárkou s dvojitou přesností, které určuje mocninu.

Návraty

Double

Číslo x zvýšené na mocninu y.

Příklady

Následující příklad používá metodu Pow k výpočtu hodnoty, která je výsledkem zvýšení hodnoty 2 na výkon v rozsahu od 0 do 32.

C#

int value = 2;
for (int power = 0; power <= 32; power++)
   Console.WriteLine($"{value}^{power} = {(long)Math.Pow(value, power):N0} (0x{(long)Math.Pow(value, power):X})");

// The example displays the following output:
//     2^0 = 1 (0x1)
//     2^1 = 2 (0x2)
//     2^2 = 4 (0x4)
//     2^3 = 8 (0x8)
//     2^4 = 16 (0x10)
//     2^5 = 32 (0x20)
//     2^6 = 64 (0x40)
//     2^7 = 128 (0x80)
//     2^8 = 256 (0x100)
//     2^9 = 512 (0x200)
//     2^10 = 1,024 (0x400)
//     2^11 = 2,048 (0x800)
//     2^12 = 4,096 (0x1000)
//     2^13 = 8,192 (0x2000)
//     2^14 = 16,384 (0x4000)
//     2^15 = 32,768 (0x8000)
//     2^16 = 65,536 (0x10000)
//     2^17 = 131,072 (0x20000)
//     2^18 = 262,144 (0x40000)
//     2^19 = 524,288 (0x80000)
//     2^20 = 1,048,576 (0x100000)
//     2^21 = 2,097,152 (0x200000)
//     2^22 = 4,194,304 (0x400000)
//     2^23 = 8,388,608 (0x800000)
//     2^24 = 16,777,216 (0x1000000)
//     2^25 = 33,554,432 (0x2000000)
//     2^26 = 67,108,864 (0x4000000)
//     2^27 = 134,217,728 (0x8000000)
//     2^28 = 268,435,456 (0x10000000)
//     2^29 = 536,870,912 (0x20000000)
//     2^30 = 1,073,741,824 (0x40000000)
//     2^31 = 2,147,483,648 (0x80000000)
//     2^32 = 4,294,967,296 (0x100000000)

Poznámky

Následující tabulka uvádí vrácenou hodnotu, pokud jsou pro x parametry a y zadány různé hodnoty nebo rozsahy hodnot. Další informace najdete v tématech Double.PositiveInfinity, Double.NegativeInfinity a Double.NaN.

x	y	Vrácená hodnota
Libovolná hodnota s výjimkou NaN	±0	1
NaN	±0	1 (NaN v rozhraní .NET Framework)*
NaN	Libovolná hodnota kromě 0	NaN*
±0	< 0 a liché celé číslo	NegativeInfinity nebo PositiveInfinity
±0	NegativeInfinity	PositiveInfinity
±0	PositiveInfinity	+0
±0	> 0 a liché celé číslo	±0
-1	NegativeInfinity nebo PositiveInfinity	1
+1	Libovolná hodnota s výjimkou NaN	1
+1	NaN	1 (NaN v rozhraní .NET Framework)*
Libovolná hodnota kromě 1	NaN	NaN*
-1 < x < 1	PositiveInfinity	+0
< -1 nebo > 1	PositiveInfinity	PositiveInfinity
-1 < x < 1	NegativeInfinity	PositiveInfinity
< -1 nebo > 1	NegativeInfinity	+0
PositiveInfinity	< 0	+0
PositiveInfinity	> 0	PositiveInfinity
NegativeInfinity	< 0 a konečné a liché celé číslo	-0
NegativeInfinity	> 0 a konečné a liché celé číslo	NegativeInfinity
NegativeInfinity	< 0 a konečné a ne liché celé číslo	+0
NegativeInfinity	> 0 a konečné a ne liché celé číslo	PositiveInfinity
±0	< 0 a konečné a ne liché celé číslo	PositiveInfinity
±0	> 0 a konečné a ne liché celé číslo	+0
< 0, ale ne NegativeInfinity	Konečný non-integer	NaN

* Tyto řádky se nezobrazují v úplné sadě pravidel pro pow , jak je definováno standardem IEEE pro Floating-Point aritmetika. Jsou sem zahrnuté, protože .NET zakazuje výjimky IEEE 754 s plovoucí desetinnou čárkou, a proto nerozlišuje mezi qNaN (tiché NaN) a sNaN (signalizují NaN). Specifikace IEEE 754 toto zakázání výjimky umožňuje.

Tato metoda volá základní modul runtime jazyka C a přesný výsledek nebo platný rozsah vstupu se může v různých operačních systémech nebo architekturách lišit.

Viz také

• Sqrt(Double)