Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

atanh — funkcja biblioteki C23

`atanh(double x)` z `<math.h>` zwraca rzeczywistą główną wartość odwrotnego tangensa hiperbolicznego. Dla skończonego rzeczywistego wyniku argument musi należeć do otwartego przedziału `(-1, 1)`.

Wersja: C23

Składnia

double atanh(double x);

atanh(double x) z <math.h> zwraca rzeczywistą główną wartość odwrotnego tangensa hiperbolicznego. Dla skończonego rzeczywistego wyniku argument musi należeć do otwartego przedziału (-1, 1).

Odwraca zależność tanh, na przykład przy odzyskiwaniu parametru hiperbolicznego z ograniczonego współczynnika. Przykład rzeczywiście oblicza atanh(0.5) i drukuje 0.549.

W bazowym C23 dla x = ±1 błąd bieguna może wystąpić, a zwracana wartość jest zależna od implementacji; dla |x| > 1 występuje błąd dziedziny, również z wartością zależną od implementacji. Błąd zakresu może wystąpić dla niezerowego x tak bliskiego zeru, że wynik underflowuje. Dopiero Annex F dla IEC 60559 wymaga zachowania ±0, ±∞ i wyjątku dzielenia przez zero przy ±1, NaN i invalid poza dziedziną oraz propagacji NaN.

Przykłady

#include <math.h>
#include <stdio.h>

int main(void) {
    double value = atanh(0.5);
    printf("%.3f\n", value);
    return 0;
}

Wynik

0.549

Odwraca zależność `tanh`, na przykład przy odzyskiwaniu parametru hiperbolicznego z ograniczonego współczynnika. Przykład rzeczywiście oblicza `atanh(0.5)` i drukuje `0.549`.

Źródła