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);

   Mit Glibc erforderliche Feature-Test-Makros (siehe feature_test_macros(7)):

       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 ein 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

       cabs(3), sqrt(3)

Ü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 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ 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 ⟨debian-l10n-german@lists.debian.org⟩.