Provided by: manpages-de-dev_0.10-1_all bug

BEZEICHNUNG

       pow, powf, powl - Potenzfunktionen

"UBERSICHT

       #include <math.h>

       double pow(double x, double y);
       float powf(float x, float y);
       long double powl(long double x, long double y);

       Linken Sie mit der Option -lm.

   Mit Glibc erforderliche Makros (siehe feature_test_macros(7)):

       powf(), powl():
           _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 600 ||
           _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L;
           oder cc -std=c99

BESCHREIBUNG

       Die Funktion pow() gibt die y-te Potenz von x zuruck.

R"UCKGABEWERT

       Bei erfolgreicher Ausfuhrung geben diese Funktionen die y-te Potenz von
       x zuruck.

       Falls x ein endlicher Wert kleiner 0 und y endlich und keine ganze Zahl
       (Integer) ist, tritt ein Eingabe-Bereichsfehler (>>domain error<<)  auf
       und es wird ein NaN zuruckgegeben.

       Bei  einem  Uberlauf  des Ergebnisses tritt ein Ergebnis-Bereichsfehler
       ein;  die  Funktionen  geben  entsprechend  HUGE_VAL,  HUGE_VALF   oder
       HUGE_VALL mit dem mathematisch richtigen Vorzeichen zuruck.

       Wenn im Ergebnis eine Bereichsunterschreitung auftritt und das Ergebnis
       nicht darstellbar ist, tritt ein Ergebnis-Bereichsfehler ein. In diesem
       Fall ist der Ruckgabewert 0.

       Mit  Ausnahme der im Folgenden beschriebenen Falle ist das Ergebnis ein
       >>NaN<<, wenn x oder y ein >>NaN<< ist.

       Wenn x den Wert +1 hat, dann ist das Ergebnis 1.0  (sogar  wenn  y  ein
       >>NaN<< ist).

       Wenn  y  den  Wert  0  hat, dann ist das Ergebnis 1.0 (sogar wenn x ein
       >>NaN<< ist).

       Wenn x gleich +0 (-0) und y eine ungerade ganze Zahl groBer als 0  ist,
       ist das Ergebnis +0 (-0).

       Wenn  x  gleich 0 und y groBer als 0 und keine ungerade ganze Zahl ist,
       ist das Ergebnis +0.

       Wenn x gleich -1 und y positiv unendlich oder  negativ  unendlich  ist,
       ist das Ergebnis 1.0.

       Wenn  der  Absolutwert  von x kleiner als 1 ist und y negativ unendlich
       ist, ist das Ergebnis positiv unendlich.

       Wenn der Absolutwert von x groBer als 1 und y  negativ  unendlich  ist,
       ist das Ergebnis +0.

       Wenn  der  Absolutwert von x kleiner als 1 und y positiv unendlich ist,
       ist das Ergebnis +0.

       Wenn der Absolutwert von x groBer als 1 und y  positiv  unendlich  ist,
       ist das Ergebnis positiv unendlich.

       Wenn  x  negativ  unendlich  und  y  eine ungerade ganze Zahl (Integer)
       kleiner 0 ist, ist das Ergebnis -0.

       Wenn x negativ unendlich und y keine ungerade ganze Zahl kleiner 0 ist,
       ist das Ergebnis +0.

       Wenn  x  negativ unendlich und y eine ungerade ganze Zahl groBer 0 ist,
       ist das Ergebnis negativ unendlich.

       Wenn x negativ unendlich und y groBer als 0 und  keine  ungerade  ganze
       Zahl ist, ist das Ergebnis positiv unendlich.

       Wenn x positiv unendlich und y kleiner als 0 ist, ist das Ergebnis +0.

       Wenn  x  positiv  unendlich und y groBer als Null ist, ist das Ergebnis
       positiv unendlich.

       Wenn x gleich +0 oder -0 und y eine ungerade ganze Zahl kleiner  als  0
       ist,  tritt  ein  Polfehler  ein.  Der  Ruckgabewert ist dann HUGE_VAL,
       HUGE_VALF oder HUGE_VALL mit dem Vorzeichen von x.

       Wenn x gleich +0 oder -0 ist und y kleiner als  0  und  keine  ungerade
       ganze  Zahl  ist,  tritt  ein  Polfehler ein. Der Ruckgabewert ist dann
       HUGE_VAL, HUGE_VALF oder HUGE_VALL.

FEHLER

       In math_error(7) erfahren  Sie,  wie  Sie  Fehler  bei  der  Ausfuhrung
       mathematischer Funktionen erkennen.

       Die folgenden Fehler konnen auftreten:

       Eingabe-Bereichsfehler:  x  ist  negativ und y ist eine endliche, nicht
       ganze Zahl (noninteger).
              errno  wird  auf  EDOM  gesetzt.  Ein  FlieBkomma-Ausnahmefehler
              (FE_INVALID) wird ausgelost.

       Polfehler: x ist 0 und y ist negativ.
              errno  wird  auf ERANGE gesetzt (siehe aber FEHLER). Es wird der
              FlieBkomma-Ausnahmefehler >>Division durch Null<< (FE_DIVBYZERO)
              ausgelost.

       Ergebnis-Bereichsfehler: Uberlauf
              errno     wird    auf    ERANGE    gesetzt.    Es    wird    ein
              FlieBkomma-Ausnahmefehler (E_OVERFLOW) ausgelost.

       Ergebnis-Bereichsfehler: Unterschreitung
              errno    wird    auf    ERANGE    gesetzt.    Es    wird     der
              FlieBkomma-Ausnahmefehler    >>Unterschreitung<<   (E_UNDERFLOW)
              ausgelost.

KONFORM ZU

       C99, POSIX.1-2001. Die Variante, die double  zuruckgibt,  ist  auBerdem
       konform zu SVr4, 4.3BSD, C89.

FEHLER

       Bis  Version  2.9  der Glibc wird beim Eintreten eines Polfehlers errno
       auf EDOM gesetzt und nicht auf  ERANGE,  wie  es  POSIX  fordert.  Seit
       Version 2.10 verhalt sich Glibc korrekt.

       Wenn  x  negativ ist, bewirken groBe negative oder positive y-Werte als
       Ergebnis der Funktion ein NaN, setzen errno  auf  EDOM  und  losen  den
       FlieBkomma-Ausnahmefehler  FE_INVALID  aus.  Dieses  Verhalten  ist mit
       pow() zu beobachten,  wenn  der  Absolutwert  von  y  groBer  als  etwa
       9.223373e18 ist.

       Bis  einschlieBlich  Version  2.3.2:  wenn  ein Uberlauf oder Unterlauf
       auftritt,  erzeugt  die  Glibc-Version  von  pow()  einen  zusatzlichen
       (ungultige) FlieBkomma-Ausnahmefehler (FE_INVALID).

SIEHE AUCH

       cbrt(3), cpow(3), sqrt(3)

KOLOPHON

       Diese   Seite   ist   Teil   der  Veroffentlichung  3.32  des  Projekts
       Linux-man-pages. Eine Beschreibung des Projekts und Informationen,  wie
       Fehler     gemeldet     werden     konnen,     finden     sich    unter
       http://www.kernel.org/doc/man-pages/.

"UBERSETZUNG

       Die  deutsche  Ubersetzung  dieser   Handbuchseite   wurde   von   Maik
       Messerschmidt  <Maik.Messerschmidt@gmx.net> und Martin Eberhard Schauer
       <Martin.E.Schauer@gmx.de> erstellt.

       Diese Ubersetzung ist Freie Dokumentation; lesen Sie  die  GNU  General
       Public   License   Version   3  oder  neuer  bezuglich  der  Copyright-
       Bedingungen. Es wird KEINE HAFTUNG ubernommen.

       Wenn  Sie  Fehler  in  der  Ubersetzung  dieser  Handbuchseite  finden,
       schicken     Sie     bitte     eine     E-Mail     an     <debian-l10n-
       german@lists.debian.org>.

                              12. September 2010                        POW(3)