.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk) .\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk .\" .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" References consulted: .\" Linux libc source code .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified 1993-07-24 by Rik Faith (faith@cs.unc.edu) .\" Modified 1995-08-14 by Arnt Gulbrandsen .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH pow 3 "20. Juli 2023" "Linux man\-pages 6.05.01" .SH BEZEICHNUNG pow, powf, powl \- Potenzfunktionen .SH BIBLIOTHEK Mathematik\-Bibliothek (\fIlibm\fP, \fI\-lm\fP) .SH ÜBERSICHT .nf \fB#include \fP .PP \fBdouble pow(double \fP\fIx\fP\fB, double \fP\fIy\fP\fB);\fP \fBfloat powf(float \fP\fIx\fP\fB, float \fP\fIy\fP\fB);\fP \fBlong double powl(long double \fP\fIx\fP\fB, long double \fP\fIy\fP\fB);\fP .fi .PP .RS -4 Mit Glibc erforderliche Feature\-Test\-Makros (siehe \fBfeature_test_macros\fP(7)): .RE .PP \fBpowf\fP(), \fBpowl\fP(): .nf _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L || /* Seit Glibc 2.19: */ _DEFAULT_SOURCE || /* Glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .fi .SH BESCHREIBUNG Diese Funktionen geben die \fIy\fP\-te Potenz von \fIx\fP zurück. .SH RÜCKGABEWERT Bei erfolgreicher Ausführung geben diese Funktionen die \fIy\fP\-te Potenz von \fIx\fP zurück. .PP .\" The range error is generated at least as far back as glibc 2.4 Bei einem Überlauf des Ergebnisses tritt ein Ergebnis\-Bereichsfehler ein; die Funktionen geben entsprechend \fBHUGE_VAL\fP, \fBHUGE_VALF\fP oder \fBHUGE_VALL\fP mit dem mathematisch richtigen Vorzeichen zurück. .PP .\" POSIX.1 does not specify the sign of the zero, .\" but https://www.sourceware.org/bugzilla/show_bug.cgi?id=2678 .\" points out that the zero has the wrong sign in some cases. Wenn im Ergebnis eine Bereichsunterschreitung auftritt und das Ergebnis nicht darstellbar ist, tritt ein Ergebnis\-Bereichsfehler ein. In diesem Fall ist der Rückgabewert 0.0 mit dem geeigneten Vorzeichen. .PP .\" pow(\(+-0, <0 [[odd]]) = HUGE_VAL* Wenn \fIx\fP gleich +0 oder \-0 und \fIy\fP eine ungerade ganze Zahl kleiner als 0 ist, tritt ein Polfehler ein. Der Rückgabewert ist dann \fBHUGE_VAL\fP, \fBHUGE_VALF\fP oder \fBHUGE_VALL\fP mit dem Vorzeichen von \fIx\fP. .PP .\" pow(\(+-0, <0 [[!odd]]) = HUGE_VAL* .\" The pole error is generated at least as far back as glibc 2.4 Wenn \fIx\fP gleich +0 oder \-0 ist und \fIy\fP kleiner als 0 und keine ungerade ganze Zahl ist, tritt ein Polfehler ein. Der Rückgabewert ist dann \fBHUGE_VAL\fP, \fBHUGE_VALF\fP oder \fBHUGE_VALL\fP. .PP .\" pow(\(+-0, >0 [[odd]]) = \(+-0 Wenn \fIx\fP gleich +0 (\-0) und \fIy\fP eine ungerade ganze Zahl größer als 0 ist, ist das Ergebnis +0 (\-0). .PP .\" pow(\(+-0, >0 [[!odd]]) = +0 Wenn \fIx\fP gleich 0 und \fIy\fP größer als 0 und keine ungerade ganze Zahl ist, ist das Ergebnis +0. .PP .\" pow(-1, \(+-INFINITY) = 1.0 Wenn \fIx\fP gleich \-1 und \fIy\fP positiv unendlich oder negativ unendlich ist, ist das Ergebnis 1.0. .PP .\" pow(+1, y) = 1.0 Wenn \fIx\fP den Wert +1 hat, dann ist das Ergebnis 1.0 (sogar wenn \fIy\fP ein »NaN« ist). .PP .\" pow(x, \(+-0) = 1.0 Wenn \fIy\fP den Wert 0 hat, dann ist das Ergebnis 1.0 (sogar wenn \fIx\fP ein »NaN« ist). .PP .\" pow(<0, y) = NaN .\" The domain error is generated at least as far back as glibc 2.4 Falls \fIx\fP ein endlicher Wert kleiner 0 und \fIy\fP endlich und keine ganze Zahl (Integer) ist, tritt ein Eingabe\-Bereichsfehler (»domain error«) auf und es wird ein NaN zurückgegeben. .PP .\" pow(|x|<1, -INFINITY) = INFINITY Wenn der Absolutwert von \fIx\fP kleiner als 1 ist und \fIy\fP negativ unendlich ist, ist das Ergebnis positiv unendlich. .PP .\" pow(|x|>1, -INFINITY) = +0 Wenn der Absolutwert von \fIx\fP größer als 1 und \fIy\fP negativ unendlich ist, ist das Ergebnis +0. .PP .\" pow(|x|<1, INFINITY) = +0 Wenn der Absolutwert von \fIx\fP kleiner als 1 und \fIy\fP positiv unendlich ist, ist das Ergebnis +0. .PP .\" pow(|x|>1, INFINITY) = INFINITY Wenn der Absolutwert von \fIx\fP größer als 1 und \fIy\fP positiv unendlich ist, ist das Ergebnis positiv unendlich. .PP .\" pow(-INFINITY, <0 [[odd]]) = -0 Wenn \fIx\fP negativ unendlich und \fIy\fP eine ungerade ganze Zahl (Integer) kleiner 0 ist, ist das Ergebnis \-0. .PP .\" pow(-INFINITY, <0 [[!odd]]) = +0 Wenn \fIx\fP negativ unendlich und \fIy\fP keine ungerade ganze Zahl kleiner 0 ist, ist das Ergebnis +0. .PP .\" pow(-INFINITY, >0 [[odd]]) = -INFINITY Wenn \fIx\fP negativ unendlich und \fIy\fP eine ungerade ganze Zahl größer 0 ist, ist das Ergebnis negativ unendlich. .PP .\" pow(-INFINITY, >0 [[!odd]]) = INFINITY Wenn \fIx\fP negativ unendlich und \fIy\fP größer als 0 und keine ungerade ganze Zahl ist, ist das Ergebnis positiv unendlich. .PP .\" pow(INFINITY, <0) = +0 Wenn \fIx\fP positiv unendlich und \fIy\fP kleiner als 0 ist, ist das Ergebnis +0. .PP .\" pow(INFINITY, >0) = INFINITY Wenn \fIx\fP positiv unendlich und \fIy\fP größer als Null ist, ist das Ergebnis positiv unendlich. .PP .\" pow(NaN, y) or pow(x, NaN) = NaN Mit Ausnahme der im Vorgehenden beschriebenen Fälle ist das Ergebnis ein »NaN«, wenn \fIx\fP oder \fIy\fP ein »NaN« ist. .SH FEHLER .\" FIXME . review status of this error .\" longstanding bug report for glibc: .\" https://www.sourceware.org/bugzilla/show_bug.cgi?id=369 .\" For negative x, and -large and +large y, glibc 2.8 gives incorrect .\" results .\" pow(-0.5,-DBL_MAX)=nan .\" EDOM FE_INVALID nan; fail-errno fail-except fail-result; .\" FAIL (expected: range-error-overflow (ERANGE, FE_OVERFLOW); +INF) .\" .\" pow(-1.5,-DBL_MAX)=nan .\" EDOM FE_INVALID nan; fail-errno fail-except fail-result; .\" FAIL (expected: range-error-underflow (ERANGE, FE_UNDERFLOW); +0) .\" .\" pow(-0.5,DBL_MAX)=nan .\" EDOM FE_INVALID nan; fail-errno fail-except fail-result; .\" FAIL (expected: range-error-underflow (ERANGE, FE_UNDERFLOW); +0) .\" .\" pow(-1.5,DBL_MAX)=nan .\" EDOM FE_INVALID nan; fail-errno fail-except fail-result; .\" FAIL (expected: range-error-overflow (ERANGE, FE_OVERFLOW); +INF) In \fBmath_error\fP(7) erfahren Sie, wie Sie Fehler bei der Ausführung dieser Funktionen erkennen. .PP Die folgenden Fehler können auftreten: .TP Eingabe\-Bereichsfehler: \fIx\fP ist negativ und \fIy\fP ist eine endliche, nicht ganze Zahl (noninteger). \fIerrno\fP wird auf \fBEDOM\fP gesetzt. Es wird der Fließkomma\-Ausnahmefehler »unzulässige Fließkommazahl« (\fBFE_INVALID\fP) ausgelöst. .TP Polfehler: \fIx\fP ist 0 und \fIy\fP ist negativ. \fIerrno\fP wird auf \fBERANGE\fP gesetzt (siehe aber FEHLER). Es wird der Fließkomma\-Ausnahmefehler »Division durch Null« (\fBFE_DIVBYZERO\fP) ausgelöst. .TP Ergebnis\-Bereichsfehler: Überlauf \fIerrno\fP wird auf \fBERANGE\fP gesetzt. Es wird ein Fließkomma\-Ausnahmefehler »Überlauf« (\fBFE_OVERFLOW\fP) ausgelöst. .TP Ergebnis\-Bereichsfehler: Unterschreitung \fIerrno\fP wird auf \fBERANGE\fP gesetzt. Es wird der Fließkomma\-Ausnahmefehler »Unterschreitung« (\fBFE_UNDERFLOW\fP) ausgelöst. .SH ATTRIBUTE Siehe \fBattributes\fP(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke. .TS allbox; lbx lb lb l l l. Schnittstelle Attribut Wert T{ .na .nh \fBpow\fP(), \fBpowf\fP(), \fBpowl\fP() T} Multithread\-Fähigkeit MT\-Sicher .TE .sp 1 .SH STANDARDS C11, POSIX.1\-2008. .SH GESCHICHTE C99, POSIX.1\-2001. .PP Die Variante, die \fIdouble\fP zurückgibt, ist außerdem konform zu SVr4, 4.3BSD, C89. .SH FEHLER .SS "Historische Fehler (jetzt behoben)" .\" https://sourceware.org/bugzilla/show_bug.cgi?id=13932 .\" commit c3d466cba1692708a19c6ff829d0386c83a0c6e5 Vor Glibc 2.28 war \fBpow\fP() für bestimmte (seltene) Eingaben auf einigen Architekturen (z.B. X86\-64) mehr als 10.000\-fach langsamer als bei nahe beiliegenden Eingaben. Dies betrifft nur \fBpow\fP() und nicht \fBpowf\fP() oder \fBpowl\fP(). Dieses Problem wurde in Glibc 2.28 behoben. .PP .\" https://www.sourceware.org/bugzilla/show_bug.cgi?id=3866 Eine Reihe von Fehlern in der Glibc\-Implementierung von \fBpow\fP() wurde in Glibc 2.16 behoben. .PP .\" .\" https://www.sourceware.org/bugzilla/show_bug.cgi?id=6776 .\" or possibly 2.9, I haven't found the source code change .\" and I don't have a 2.9 system to test Bis einschließlich Glibc 2.9 wurde \fIerrno\fP bei Auftreten eines Polfehlers auf \fBEDOM\fP gesetzt, statt auf das von POSIX vorgeschriebene \fBERANGE\fP. Seit Glibc 2.10 verhält sich Glibc richtig. .PP .\" Actually, glibc 2.3.2 is the earliest test result I have; so yet .\" to confirm if this error occurs only in glibc 2.3.2. Bis einschließlich Glibc 2.3.2: wenn ein Überlauf oder Unterlauf auftritt, erzeugt die Glibc\-Version von \fBpow\fP() einen zusätzlichen (ungültigen) Fließkomma\-Ausnahmefehler (\fBFE_INVALID\fP). .SH "SIEHE AUCH" \fBcbrt\fP(3), \fBcpow\fP(3), \fBsqrt\fP(3) .PP .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Maik Messerschmidt , Martin Eberhard Schauer und Helge Kreutzmann erstellt. .PP Diese Übersetzung ist Freie Dokumentation; lesen Sie die .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen. .PP Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die .MT debian-l10n-german@lists.debian.org Mailingliste der Übersetzer .ME .