Math.Pow(Double, Double) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vrátí zadané číslo umocněné na zadanou mocninu.
public:
static double Pow(double x, double y);
public static double Pow(double x, double y);
static member Pow : double * double -> double
Public Shared Function Pow (x As Double, y As Double) As Double
Parametry
- x
- Double
Číslo s plovoucí desetinnou čárkou s dvojitou přesností, které má být umocněna na mocninu.
- y
- Double
Číslo s plovoucí desetinnou čárkou s dvojitou přesností, které určuje mocninu.
Návraty
Číslo x umocněné na mocninu y.
Příklady
Následující příklad používá metodu Pow k výpočtu hodnoty, která má za následek zvýšení hodnoty 2 na mocninu v rozsahu od 0 do 32.
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)
open System
let value = 2
for power = 0 to 32 do
printfn $"{value}^{power} = {Math.Pow(value, power) |> int64:N0} (0x{Math.Pow(value, power) |> int64: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)
Public Module Example
Public Sub Main
Dim value As Integer = 2
For power As Integer = 0 To 32
Console.WriteLine("{0}^{1} = {2:N0} (0x{2:X})", _
value, power, CLng(Math.Pow(value, power)))
Next
End Sub
End Module
' 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 označuje návratové hodnoty, pokud jsou pro parametry xy zadány různé hodnoty nebo rozsahy hodnot. Další informace najdete v tématech Double.PositiveInfinity, Double.NegativeInfinity a Double.NaN.
| x | Y | Návratová hodnota |
|---|---|---|
Libovolná hodnota s výjimkou NaN |
±0 | 1 |
NaN |
±0 | 1* |
NaN |
Libovolná hodnota s výjimkou 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* |
| Libovolná hodnota s výjimkou 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 až |
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 |
Koncové celé číslo | NaN |
* Tyto řádky se nezobrazují v úplné sadě pravidel definovaných powstandardem IEEE pro Floating-Point Aritmetika. Jsou tady zahrnuté, protože .NET zakáže výjimky s plovoucí desetinnou čárkou IEEE 754, a proto nerozlišuje mezi qNaN (quiet NaN) a sNaN (signalling NaN). Specifikace IEEE 754 umožňuje toto zakázání výjimky.
Tato metoda volá základní modul runtime jazyka C a přesný výsledek nebo platný vstupní rozsah se může lišit mezi různými operačními systémy nebo architekturami.