pow

(PHP 4, PHP 5, PHP 7, PHP 8)

powPotenzfunktion

Beschreibung

pow(mixed $num, mixed $exponent): int|float|object

Berechnet die Potenz von exponent zur Basis num oder kurz numexponent.

Hinweis:

Alternativ kann der **-Operator verwendet werden.

Parameter-Liste

num

Die zu potenzierende Basis.

exponent

Der Exponent.

Rückgabewerte

num in der Potenz exponent. Sind beide Argumente nichtnegative Ganzzahlen und kann das Ergebnis als Ganzzahl dargestellt werden, wird das Ergebnis als int zurückgegeben, andernfalls als float.

Das Verhalten dieser Operation kann durch PHP-Erweiterungen überschrieben werden, sodass sie ein Objekt zurückgibt.

Changelog

Version Beschreibung
8.4.0 Die Anwendung eines negativen exponenten auf 0 ist nun veraltet.

Beispiele

Beispiel #1 Einige pow()-Beispiele

<?php

var_dump
(pow(2, 8)); // int(256)
echo pow(-1, 20), PHP_EOL; // 1
echo pow(0, 0), PHP_EOL; // 1
echo pow(10, -1), PHP_EOL; // 0.1
var_dump(pow(new GMP("3"), new GMP("2"))); // object(GMP)

echo pow(-1, 5.5); // NAN

?>

Anmerkungen

Hinweis:

Diese Funktion wandelt alle Eingaben in numerische Werte um, selbst nicht-skalare Werte. Dies kann zu seltsamen Ergebnissen führen.

Siehe auch

  • Potenz-Operator **
  • fpow() - Raise one number to the power of another, according to IEEE 754
  • exp() - Berechnet den Exponenten von e
  • sqrt() - Quadratwurzel
  • bcpow() - Potenz einer Zahl beliebiger Genauigkeit
  • gmp_pow() - Raise number into power