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

    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 unzulässige Ü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-Sicher

STANDARDS
C11, POSIX.1-2008.

GESCHICHTE
C99, POSIX.1-2001.

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.