atanh, atanhf, atanhl

매개변수

반환값

오류가 발생하지 않으면, arg 의 역쌍곡탄젠트( tanh -1
(arg) , 또는 artanh(arg) )가 반환됩니다.

도메인 오류가 발생하면 구현에서 정의한 값이 반환됩니다(NaN을 지원하는 경우 해당 값).

극점 오류가 발생하는 경우, ± HUGE_VAL , ±HUGE_VALF , 또는 ±HUGE_VALL 가 반환됩니다 (올바른 부호와 함께).

언더플로우로 인해 범위 오류가 발생하면, 올바른 결과(반올림 후)가 반환됩니다.

오류 처리

오류는 math_errhandling 에 명시된 대로 보고됩니다.

인수가 구간 [ - 1 , + 1 ] 에 존재하지 않으면 범위 오류가 발생합니다.

인수가 ±1인 경우, 극점 오류가 발생합니다.

구현이 IEEE 부동 소수점 연산(IEC 60559)을 지원하는 경우,

• 인자가 ±0인 경우, 수정 없이 그대로 반환됩니다.
• 인자가 ±1인 경우, ±∞가 반환되고 FE_DIVBYZERO 가 발생합니다.
• 만약 |arg|>1 인 경우, NaN이 반환되고 FE_INVALID 가 발생합니다.
• 인자가 NaN인 경우, NaN이 반환됩니다.

참고 사항

C 표준에서는 이 함수를 "arc hyperbolic tangent"라고 명명하지만, 쌍곡선 함수의 역함수는 면적 함수입니다. 이들의 인수는 호(arc)가 아닌 쌍곡선 섹터의 면적입니다. 올바른 명칭은 "inverse hyperbolic tangent"(POSIX에서 사용) 또는 "area hyperbolic tangent"입니다.

POSIX는 언더플로우가 발생한 경우, arg 가 수정되지 않은 상태로 반환되도록 명시하며, 이를 지원하지 않는 경우 DBL_MIN , FLT_MIN , 그리고 LDBL_MIN 을 초과하지 않는 구현에서 정의된 값이 반환됩니다.

예제

#include <errno.h>
#include <fenv.h>
#include <float.h>
#include <math.h>
#include <stdio.h>
// #pragma STDC FENV_ACCESS ON
int main(void)
{
    printf("atanh(0) = %f\natanh(-0) = %f\n", atanh(0), atanh(-0.0));
    printf("atanh(0.9) = %f\n", atanh(0.9));
    // error handling
    errno = 0; feclearexcept(FE_ALL_EXCEPT);
    printf("atanh(-1) = %f\n", atanh(-1));
    if (errno == ERANGE)
        perror("    errno == ERANGE");
    if (fetestexcept(FE_DIVBYZERO))
        puts("    FE_DIVBYZERO raised");
}

atanh(0) = 0.000000
atanh(-0) = -0.000000
atanh(0.9) = 1.472219
atanh(-1) = -inf
    errno == ERANGE: Numerical result out of range
    FE_DIVBYZERO raised

참고문헌

참고 항목

외부 링크