table of contents
- bookworm 4.18.1-1
- bookworm-backports 4.24.0-2~bpo12+1
- testing 4.24.0-2
- unstable 4.24.0-2
hypot(3) | Library Functions Manual | hypot(3) |
BEZEICHNUNG¶
hypot, hypotf, hypotl - Euklidische Distanzfunktion
BIBLIOTHEK¶
Mathematik-Bibliothek (libm, -lm)
ÜBERSICHT¶
#include <math.h>
double hypot(double x, double y); float hypotf(float x, float y); long double hypotl(long double x, long double y);
hypot():
_ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
|| _XOPEN_SOURCE
|| /* Seit Glibc 2.19: */ _DEFAULT_SOURCE
|| /* Glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
hypotf(), hypotl():
_ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
|| /* Seit Glibc 2.19: */ _DEFAULT_SOURCE
|| /* Glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
BESCHREIBUNG¶
Diese Funktionen geben die Wurzel aus ((x*x+y*y) zurück. Das ist die Länge der Hypotenuse eines rechtwinkligen Dreiecks mit den Seitenlängen x und y oder die Entfernung des Punktes (x,y) vom Ursprung.
Die Berechnung erfolgt ohne unnötige Über-oder Unterläufe während der Zwischenschritte der Berechnung.
RÜCKGABEWERT¶
Bei Erfolg geben diese Funktionen die Länge der Hypotenuse eines rechtwinkligen Dreiecks mit den Seitenlängen x und y zurück.
Fall x oder y unendlich ist, wird plus unendlich zurückgegeben.
Falls x oder y ein NaN ist und das andere Argument kein unendlicher Wert ist, wird ein NaN zurückgegeben.
Falls das Ergebnis überläuft, tritt ein Bereichsfehler auf und die Funktionen geben HUGE_VAL, HUGE_VALF beziehungsweise HUGE_VALL zurück.
Falls beide Argumente subnormal sind und das Ergebnis subnormal ist, tritt ein Bereichsfehler auf und das korrekte Ergebnis wird zurückgegeben.
FEHLER¶
In math_error(7) erfahren Sie, wie Sie Fehler bei der Ausführung dieser Funktionen erkennen.
Die folgenden Fehler können auftreten:
- Bereichsfehler: Ergebnisüberlauf
- errno wird auf ERANGE gesetzt. Es wird der Fließkomma-Ausnahmefehler »Überlauf« (FE_OVERFLOW) ausgelöst.
- Bereichsfehler: Ergebnisunterlauf
- Es wird der Unterlauf-Fließkomma-Ausnahmefehler (FE_UNDERFLOW) ausgelöst.
- Diese Funktionen setzen für diesen Fall errno nicht.
ATTRIBUTE¶
Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.
Schnittstelle | Attribut | Wert |
hypot(), hypotf(), hypotl() | Multithread-Fähigkeit | MT-Safe |
STANDARDS¶
C99, POSIX.1-2001, POSIX.1-2008.
Die Variante, die double zurückgibt, ist außerdem konform zu SVr4, 4.3BSD.
SIEHE AUCH¶
ÜBERSETZUNG¶
Die deutsche Übersetzung dieser Handbuchseite wurde von Regine Bast <regine.bast@bigfoot.com> und Martin Eberhard Schauer <Martin.E.Schauer@gmx.de> erstellt.
Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer.
5. Februar 2023 | Linux man-pages 6.03 |