Provided by:
manpages-de-dev_0.10-1_all 
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)