Scroll to navigation

HYPOT(3) Linux-Programmierhandbuch HYPOT(3)

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

Diese Seite ist Teil der Veröffentlichung 3.74 des Projekts Linux- man-pages. Eine Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden sich unter 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