bcpow
(PHP 4, PHP 5, PHP 7, PHP 8)
bcpow — Potenz einer Zahl beliebiger Genauigkeit
Beschreibung
$num
, string $exponent
, ?int $scale
= null
): string
Potenziert num
mit
exponent
.
Parameter-Liste
-
num
-
Die Basis in Stringform.
-
exponent
-
Der Exponent in Stringform. Ist der Exponent nicht ganzzahlig, wird er abgeschnitten. Der gültige Bereich des Exponenten ist Plattformabhängig, ist allerdings wenigstens
-2147483648
bis2147483647
. -
scale
-
Dieser optionale Parameter kann benutzt werden, um die Anzahl der Nachkommastellen im Ergebnis festzulegen. Sie können mit Hilfe der bcscale()-Funktion auch einen globalen Vorgabewert für alle Funktionen festlegen.
Rückgabewerte
Gibt das Ergebnis als String zurück.
Changelog
Version | Beschreibung |
---|---|
7.3.0 | bcpow() liefert nun Zahlen mit den angeforderten Nachkommastellen zurück. Zuvor haben die zurückgelieferten Zahlen möglicherweise abschließende Dezimalnullen ausgelassen. |
Beispiele
Beispiel #1 bcpow()-Beispiel
<?php
echo bcpow('4.2', '3', 2); // 74.08
?>
Anmerkungen
Hinweis:
Vor PHP 7.3.0 kann bcpow() ein Ergebnis mit weniger Dezimalstellen liefern als der
scale
Parameter angibt. Das geschieht nur, wenn das Ergebnis nicht die gesamte Genauigkeit benötigt, die durch denscale
erlaubt ist. Zum Beispiel:Beispiel #2 bcpow() Genauigkeitsbeispiel
<?php
echo bcpow('5', '2', 2); // gibt "25" aus, nicht "25.00"
?>
Siehe auch
- bcpowmod() - Potenz einer Zahl beliebiger Genauigkeit, vermindert um ein angegebenen Modulo
- bcsqrt() - Ermittelt die Quadratwurzel einer Zahl beliebiger Genauigkeit