Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

atanh — função de biblioteca C23

`atanh(double x)` de `<math.h>` devolve o valor real principal da tangente hiperbólica inversa. Para um resultado real finito, o argumento tem de pertencer ao intervalo aberto `(-1, 1)`.

Versão: C23

Sintaxe

double atanh(double x);

atanh(double x) de <math.h> devolve o valor real principal da tangente hiperbólica inversa. Para um resultado real finito, o argumento tem de pertencer ao intervalo aberto (-1, 1).

Inverte uma relação tanh, por exemplo para recuperar um parâmetro hiperbólico de uma razão limitada. O exemplo calcula realmente atanh(0.5) e imprime 0.549.

No C23 base pode ocorrer erro de polo em x = ±1 e o valor devolvido é definido pela implementação; para |x| > 1 ocorre erro de domínio e o valor também é definido pela implementação. Pode ocorrer erro de intervalo se x não zero estiver tão perto de zero que o resultado sofra underflow. O Annex F para IEC 60559 exige ±0, infinitos com sinal e divide-by-zero em ±1, NaN e invalid fora do domínio e propagação de NaN.

Exemplos

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

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

Resultado

0.549

Inverte uma relação `tanh`, por exemplo para recuperar um parâmetro hiperbólico de uma razão limitada. O exemplo calcula realmente `atanh(0.5)` e imprime `0.549`.

Fontes