BEZEICHNUNG

       hypot, hypotf, hypotl - Euklidische Distanzfunktion

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

       Linken Sie mit der Option -lm.

   Mit Glibc erforderliche Makros (siehe feature_test_macros(7)):

       hypot():
           _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE || _ISOC99_SOURCE ||
           _POSIX_C_SOURCE >= 200112L;
           oder cc -std=c99
       hypotf(), hypotl():
           _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 600 || _ISOC99_SOURCE ||
           _POSIX_C_SOURCE >= 200112L;
           oder cc -std=c99

BESCHREIBUNG

       Die  Funktion  hypot()  gibt  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 ist kein unendlicher Wert, wird ein NaN
       zurückgegeben.

       Wenn das Ergebnis überläuft,  tritt  ein  Bereichsfehler  ein  und  die  Funktionen  geben
       entsprechend HUGE_VAL, HUGE_VALF oder 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 mathematischer 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 Fließkomma-Ausnahmefehler »Unterschreitung« (FE_UNDERFLOW) ausgelöst.

              In diesem Fall setzen diese Funktionen errno nicht.

KONFORM ZU

       C99, POSIX.1-2001. Die Variante, die double zurückgibt,  ist  außerdem  konform  zu  SVr4,
       4.3BSD.

SIEHE AUCH

       cabs(3), sqrt(3)

KOLOPHON

       This  page  is  part  of release 3.54 of the Linux man-pages project. A description of the
       project,    and    information    about    reporting    bugs,    can    be    found     at
       http://www.kernel.org/doc/man-pages/.

Ü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 <debian-l10n-german@lists.debian.org>.

                                        20. September 2010                               HYPOT(3)