Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

atanh — knihovní funkce C23

`atanh(double x)` z `<math.h>` vrací reálnou hlavní hodnotu inverzního hyperbolického tangensu. Pro konečný reálný výsledek musí argument ležet v otevřeném intervalu `(-1, 1)`.

Verze: C23

Syntaxe

double atanh(double x);

atanh(double x) z <math.h> vrací reálnou hlavní hodnotu inverzního hyperbolického tangensu. Pro konečný reálný výsledek musí argument ležet v otevřeném intervalu (-1, 1).

Obrací vztah tanh, například při získání hyperbolického parametru z omezeného poměru. Příklad skutečně vypočítá atanh(0.5) a vypíše 0.549.

V základním C23 může při x = ±1 nastat chyba pólu a vrácená hodnota je určena implementací; pro |x| > 1 nastane chyba definičního oboru a hodnota je také určena implementací. Chyba rozsahu může nastat, je-li nenulové x tak blízko nule, že výsledek podteče. Annex F pro IEC 60559 vyžaduje ±0, nekonečna se znaménkem a divide-by-zero při ±1, NaN a invalid mimo obor a šíření NaN.

Příklady

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

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

Výsledek

0.549

Obrací vztah `tanh`, například při získání hyperbolického parametru z omezeného poměru. Příklad skutečně vypočítá `atanh(0.5)` a vypíše `0.549`.

Zdroje