bcpow

(PHP 4, PHP 5, PHP 7)

bcpowPotenz einer Zahl beliebiger Genauigkeit

Beschreibung

bcpow ( string $base , string $exponent [, int $scale = 0 ] ) : string

Potenziert base mit exponent.

Parameter-Liste

base

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 bis 2147483647.

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 den scale 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