hypot, hypotf, hypotl
| Definiert in Header <math.h> |
||
| float hypotf( float x, float y ); |
(1) | (seit C99) |
| double hypot( double x, double y ); |
(2) | (seit C99) |
| long double hypotl( long double x, long double y ); |
(3) | (seit C99) |
| Definiert in Header <tgmath.h> |
||
| #define hypot( x, y ) |
(4) | (seit C99) |
Der von dieser Funktion berechnete Wert ist die Länge der Hypotenuse eines rechtwinkligen Dreiecks mit den Seitenlängen x und y, oder der Abstand des Punktes (x, y) vom Ursprung (0, 0), oder die Magnitude einer komplexen Zahl x+iy.
Inhalt |
[bearbeiten] Parameter
| x | - | Gleitkommawert |
| y | - | Gleitkommawert |
[bearbeiten] Rückgabewert
Wenn keine Fehler auftreten, wird die Hypotenuse eines rechtwinkligen Dreiecks, √x2
+y2
, zurückgegeben.
Wenn ein Bereichsfehler aufgrund von Überlauf auftritt, wird +HUGE_VAL, +HUGE_VALF oder +HUGE_VALL zurückgegeben.
Wenn ein Bereichsfehler aufgrund von Unterlauf auftritt, wird das korrekte Ergebnis (nach Rundung) zurückgegeben.
[bearbeiten] Fehlerbehandlung
Fehler werden wie in math_errhandling angegeben gemeldet.
Wenn die Implementierung IEEE-Gleitkomma-Arithmetik (IEC 60559) unterstützt,
- hypot(x, y), hypot(y, x) und hypot(x, -y) sind äquivalent
- Wenn eines der Argumente ±0 ist, ist `hypot` äquivalent zu fabs, das mit dem Nicht-Null-Argument aufgerufen wird.
- Wenn eines der Argumente ±∞ ist, gibt `hypot` +∞ zurück, auch wenn das andere Argument NaN ist.
- Andernfalls, wenn eines der Argumente NaN ist, wird NaN zurückgegeben.
[bearbeiten] Hinweise
Implementierungen garantieren normalerweise eine Präzision von weniger als 1 ulp (Einheiten in der letzten Stelle): GNU, BSD.
hypot(x, y) ist äquivalent zu cabs(x + I*y).
POSIX schreibt vor, dass Unterlauf nur dann auftreten darf, wenn beide Argumente subnormal sind und das korrekte Ergebnis ebenfalls subnormal ist (dies verbietet naive Implementierungen).
hypot(INFINITY, NAN) gibt +∞ zurück, aber sqrt(INFINITY * INFINITY + NAN * NAN) gibt NaN zurück.
[bearbeiten] Beispiel
#include <errno.h> #include <fenv.h> #include <float.h> #include <math.h> #include <stdio.h> // #pragma STDC FENV_ACCESS ON int main(void) { // typical usage printf("(1,1) cartesian is (%f,%f) polar\n", hypot(1,1), atan2(1, 1)); // special values printf("hypot(NAN,INFINITY) = %f\n", hypot(NAN, INFINITY)); // error handling errno = 0; feclearexcept(FE_ALL_EXCEPT); printf("hypot(DBL_MAX,DBL_MAX) = %f\n", hypot(DBL_MAX, DBL_MAX)); if (errno == ERANGE) perror(" errno == ERANGE"); if (fetestexcept(FE_OVERFLOW)) puts(" FE_OVERFLOW raised"); }
Mögliche Ausgabe
(1,1) cartesian is (1.414214,0.785398) polar
hypot(NAN,INFINITY) = inf
hypot(DBL_MAX,DBL_MAX) = inf
errno == ERANGE: Numerical result out of range
FE_OVERFLOW raised[bearbeiten] Referenzen
- C23-Standard (ISO/IEC 9899:2024)
- 7.12.7.3 Die hypot-Funktionen (S. TBD)
- 7.25 Typ-generische Mathematik <tgmath.h> (S. TBD)
- F.10.4.3 Die hypot-Funktionen (S. TBD)
- C17-Standard (ISO/IEC 9899:2018)
- 7.12.7.3 Die hypot-Funktionen (S. 181)
- 7.25 Typ-generische Mathematik <tgmath.h> (S. 272-273)
- F.10.4.3 Die hypot-Funktionen (S. 382)
- C11-Standard (ISO/IEC 9899:2011)
- 7.12.7.3 Die hypot-Funktionen (S. 248)
- 7.25 Typ-generische Mathematik <tgmath.h> (S. 373-375)
- F.10.4.3 Die hypot-Funktionen (S. 524)
- C99-Standard (ISO/IEC 9899:1999)
- 7.12.7.3 Die hypot-Funktionen (S. 229)
- 7.22 Typ-generische Mathematik <tgmath.h> (S. 335-337)
- F.9.4.3 Die hypot-Funktionen (S. 461)
[bearbeiten] Siehe auch
| (C99)(C99) |
berechnet eine Zahl hoch die gegebene Potenz (xy) (Funktion) |
| (C99)(C99) |
berechnet die Quadratwurzel (√x) (Funktion) |
| (C99)(C99)(C99) |
berechnet die Kubikwurzel (3√x) (Funktion) |
| (C99)(C99)(C99) |
berechnet den Betrag einer komplexen Zahl (Funktion) |
| C++ Dokumentation für hypot
| |
