pow, powl

Nach oben zu math.h - Index

Header-Datei

math.h

Kategorie

Mathematische Routinen

Prototyp

double pow(double x, double y);

long double powl(long double x, long double y);

Beschreibung

Berechnet den Wert von x hoch y.

powl ist die long double-Version. Sie benötigt ein Argument vom Typ long double und gibt ein Ergebnis vom Typ long double zurück.

Rückgabewert

Bei erfolgreicher Ausführung geben pow und powl den für x hoch y berechneten Wert zurück.

Dieser Funktion können Argumente übergeben werden, die einen Überlauf oder nicht berechenbare Ergebnisse erzeugen. Wenn der korrekte Wert einen Überlauf erzeugen würde, geben diese Funktionen den Wert HUGE_VAL (pow) bzw. _LHUGE_VAL (powl) zurück. Bei Ergebnissen zu großer Größe wird der globalen Variablen errno u. U. folgender Wert zugewiesen:

ERANGE

Result out of range (Ergebnis außerhalb des zulässigen Wertebereichs)

Wenn das an pow oder powl übergebene Argument x eine reelle Zahl und kleiner 0 ist und y keine ganze Zahl ist oder wenn x gleich 0 und y kleiner 0 ist oder wenn pow(0,0) aufgerufen wird, wird der globalen Variablen errno folgender Wert zugewiesen:

EDOM	Domain error (Domain-Fehler)

Die Fehlerbehandlung für diese Funktionen kann über die Funktionen _matherr und _matherrl geändert werden.

Beispiel

 #include <math.h>
 #include <stdio.h>
 int main(void)
 {
   double x = 2,0, y = 3,0;
   printf("%lf raised to %lf is %lf\n", x, y, pow(x, y));
   return 0;
 }

Portabilität

	POSIX	Win32	ANSI C	ANSI C++
pow	+	+	+	+
powl		+	+	+