plucky (3) hypotl.3.gz

Provided by: manpages-pl-dev_4.25.1-1_all bug

NAZWA

       hypot, hypotf, hypotl - funkcja odległości euklidesowej

BIBLIOTEKA

       Biblioteka matematyczna (libm, -lm)

SKŁADNIA

       #include <math.h>

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

   Wymagane ustawienia makr biblioteki glibc (patrz feature_test_macros(7)):

       hypot():
           _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
               || _XOPEN_SOURCE
               || /* Od glibc 2.19: */ _DEFAULT_SOURCE
               || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

       hypotf(), hypotl():
       _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
           || /* Od glibc 2.19: */ _DEFAULT_SOURCE
           || /* glibc w wersji <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

OPIS

       Funkcje  te  zwracają  sqrt(x*x+y*y). Jest to długość przeciwprostokątnej trójkąta prostokątnego o bokach
       długości x i y, lub odległość punktu (x,y) od początku układu współrzędnych.

       Wyliczenia są prowadzone bez przejmowania się nadmiarami lub niedomiarami pośrednich kroków obliczeń.

WARTOŚĆ ZWRACANA

       Funkcje te, gdy się zakończą pomyślnie, zwracają długość  przeciwprostokątnej  trójkąta  prostokątnego  z
       bokami o długościach x i y.

       Jeśli x lub y jest równe nieskończoności, to zwracana jest dodatnia nieskończoność.

       Jeśli x lub y jest równe NaN, a drugi argument nie jest nieskończonością, to zwracane jest  NaN.

       W  przypadku  przepełnienia  wyniku  operacji,  występuje  błąd  zakresu  i  funkcje zwracają odpowiednio
       HUGE_VAL, HUGE_VALF lub HUGE_VALL.

       Jeśli oba argumenty są zdenormalizowane, wynik także jest zdenormalizowany, występuje  błąd  dziedziny  i
       zwracany jest poprawny wynik.

BŁĘDY

       Informacje  o  tym,  jak  określić,  czy  wystąpił  błąd  podczas wywołania tych funkcji, można znaleźć w
       podręczniku math_error(7).

       Mogą wystąpić następujące błędy:

       Błąd zakresu: przekroczenie w górę wartości wynikowej
              errno  jest  ustawiane  na  ERANGE.  Rzucany   jest   wyjątek   przekroczenia   zakresu   operacji
              zmiennoprzecinkowej (FE_OVERFLOW).

       Błąd zakresu: przekroczenie w dół wartości wynikowej
              Rzucany jest wyjątek przekroczenia w dół zakresu operacji zmiennoprzecinkowej (FE_UNDERFLOW).

              Funkcje te nie ustawiają errno w tym przypadku.

ATRYBUTY

       Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku attributes(7).

       ┌───────────────────────────────────────────────────────────────┬────────────────────────┬───────────────┐
       │InterfejsAtrybutWartość       │
       ├───────────────────────────────────────────────────────────────┼────────────────────────┼───────────────┤
       │hypot(), hypotf(), hypotl()                                    │ Bezpieczeństwo wątkowe │ MT-bezpieczne │
       └───────────────────────────────────────────────────────────────┴────────────────────────┴───────────────┘

STANDARDY

       C11, POSIX.1-2008.

HISTORIA

       C99, POSIX.1-2001.

       Wariant zwracający wartość typu double jest zgodny również z SVr4, 4.3BSD.

ZOBACZ TAKŻE

       cabs(3), sqrt(3)

TŁUMACZENIE

       Autorami    polskiego    tłumaczenia   niniejszej   strony   podręcznika   są:   Andrzej   Krzysztofowicz
       <ankry@green.mf.pg.gda.pl>, Robert Luberda <robert@debian.org> i Michał Kułach <michal.kulach@gmail.com>

       Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje  o  warunkach  licencji  można  uzyskać
       zapoznając  się  z  GNU General Public License w wersji 3 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ lub
       nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.

       Błędy w tłumaczeniu  strony  podręcznika  prosimy  zgłaszać  na  adres  listy  dyskusyjnej  ⟨manpages-pl-
       list@lists.sourceforge.net⟩.