Scroll to navigation

HYPOT(3) Linux - příručka programátora HYPOT(3)

JMÉNO

hypot, hypotf, hypotl - eukleidovská vzdálenost

SYNTAXE

#include <math.h>

double hypot(double x, double y);
float hypotf(float x, float y);
long double hypotl(long double x,long  double y);

Vyžaduje Feature Test Makro pro glibc (viz feature_test_macros(7)):

Linkujte s -lm

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

POPIS

Funkce hypot() vrací hodnotu sqrt(x*x + y*y). Je to velikost přepony pravoúhlého trojúhelníka s odvěsnami x a y, neboli vzdálenost bodu (x, y) od počátku.

Výpočet je prováděn bez zbytečných přetečení nebo podtečení během vnitřních fází výpočtu.

NÁVRATOVÁ HODNOTA

Při úspěchu funkce vrací délku přepony pravoúhlého trojúhelníka se stranami délky x a y.

Pokud je x nebo y nekonečno, je vráceno plus nekonečno.

Pokud je x nebo y NaN a druhý argument není nekonečno, je vráceno NaN.

Pokud výsledek přeteče, je vyvolána chyba rozsahu a funkce vráti HUGE_VAL, HUGE_VALF nebo HUGE_VALL.

Pokud jsou oba argumenty podprůměrné a výsledek je také podprůměrný, je vystavena chyba rozsahu a je vrácen korektní výsledek.

CHYBY

Pro více informací zda funkce při svém volání generovala chybu viz math_error(7).

Mohou se objevit následující chyby:

errno je nastaveno na hodnotu ERANGE.
Je vystavena výjimka přetečení v pohyblivé řádové čárce(FE_OVERFLOW).

Chyba rozsahu: podtečení výsledku Je vystavena výjimka podtečení v pohyblivé řádové čárce(FE_UNDERFLOW).

Funkce v tomto případě nenastavuje errno.

SPLŇUJE STANDARDY

C99, POSIX.1-2001. Varianta vracející double splňuje taká SVr4 a 4.3BSD.

DALŠÍ INFORMACE

cabs(3), sqrt(3)

TIRÁŽ

Tato stránka je součástí projektu Linux man-pages. Popis projektu a informace o hlášení chyb najdete na http://www.kernel.org/doc/man-pages/.

9. října 2009