Scroll to navigation

atanh(3) Library Functions Manual atanh(3)

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:

errno jest ustawiane na EDOM. Rzucany jest wyjątek niepoprawnej operacji zmiennoprzecinkowej (FE_INVALID).
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.

2 maja 2024 r. Linux man-pages (niewydane)