hypot, hypotl

Nach oben zu math.h - Index

Header-Datei

math.h

Kategorie

Mathematische Routinen

Prototyp

double hypot(double x, double y);

long double hypotl(long double x, long double y);

Beschreibung

Berechnet die Hypotenuse eines rechtwinkligen Dreiecks.

hypot berechnet den Wert z, wobei gilt

z2 = x2 + y2 und z >= 0.

Dies entspricht der Länge der Hypotenuse eines rechtwinkligen Dreiecks, wenn die beiden Seiten die Länge x und y haben.

hypotl ist die long double-Version. Sie benötigt ein Argument vom Typ long double und gibt ein Ergebnis vom Typ long double zurück.

Rückgabewert

Bei erfolgreicher Ausführung geben diese Funktionen den Wert z zurück, der vom Typ double (hypot) bzw. long double) (hypotl) ist. Im Fehlerfall (z. B. wenn ein Überlauf auftritt) wird der globalen Variablen errno folgender Wert zugewiesen

ERANGE

Result out of range (Ergebnis außerhalb des zulässigen Wertebereichs)

und der Wert HUGE_VAL (hypot) bzw. _LHUGE_VAL) (hypotl) zurückgegeben. Die Fehlerbehandlung für diese Routinen kann über die Funktionen _matherr und _matherrl geändert werden.

Beispiel

 #include <stdio.h>
 #include <math.h>
 int main(void)
 {
  double result;
  double x = 3.0;
     double y = 4.0;
     result = hypot(x, y);
     printf("The hypotenuse is: %lf\n", result);
     return 0;
 }

Portabilität

	POSIX	Win32	ANSI C	ANSI C++
hypot		+	+	+
hypotl		+	+	+