NAZWA

       atanh, atanhf, atanhl - funkcja odwrotna do tangensa hiperbolicznego

BIBLIOTEKA

       Biblioteka matematyczna (libm, -lm)

SKŁADNIA

       #include <math.h>

       double atanh(double x);
       float atanhf(float x);
       long double atanhl(long double x);

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

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

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

OPIS

       Funkcje  te  obliczają  funkcję odwrotną do tangensa hiperbolicznego dla x, to znaczy wartość, dla której
       tangens hiperboliczny wynosi x.

WARTOŚĆ ZWRACANA

       Funkcje te, gdy się zakończą pomyślnie, zwracają odwrotność tangensa hiperbolicznego argumentu x.

       Jeśli x wynosi NaN, to zwracane jest NaN.

       Jeśli x wynosi +0 (-0), to zwracane jest +0 (-0).

       Jeśli x jest równe +1 lub -1, występuje błąd bieguna i funkcje odpowiednio zwracają  HUGE_VAL,  HUGE_VALF
       lub HUGE_VALL z poprawnie ustawionym znakiem.

       Jeśli wartość bezwzględna x jest większa od 1, to występuje błąd dziedziny i zwracane jest NaN.

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 dziedziny: x jest mniejsze niż -1 lub większe niż +1
              errno jest ustawiane na EDOM.  Rzucany  jest  wyjątek  niepoprawnej  operacji  zmiennoprzecinkowej
              (FE_INVALID).

       Błąd bieguna: x jest równe +1 lub -1
              errno  jest  ustawiane  na ERANGE (patrz także USTERKI). Rzucany jest wyjątek zmiennoprzecinkowego
              dzielenia przez zero (FE_DIVBYZERO).

ATRYBUTY

       Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku attributes(7).
       ┌──────────────────────────────────────────────────────────────┬────────────────────────┬───────────────┐
       │ Interfejs                                                    │ Atrybut                │ Wartość       │
       ├──────────────────────────────────────────────────────────────┼────────────────────────┼───────────────┤
       │ atanh(), atanhf(), atanhl()                                  │ 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.

USTERKI

       W wersji 2.9 i wcześniejszych biblioteki glibc w razie wystąpienia błędu bieguna errno jest ustawiane  na
       EDOM zamiast na ERANGE, jak tego wymaga standard POSIX. Zostało to poprawione w glibc 2.10.

ZOBACZ TAKŻE

       acosh(3), asinh(3), catanh(3), cosh(3), sinh(3), tanh(3)

TŁUMACZENIE

       Autorami  polskiego  tłumaczenia  niniejszej  strony  podręcznika  są: Adam Byrtek <alpha@irc.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   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.

Linux man-pages 6.9.1                            2 maja 2024 r.                                         atanh(3)