Namespaces
Variants

std:: atanh (std::complex)

From cppreference.net
C++
Numerics library
std::complex
헤더 파일에 정의됨 <complex>
template < class T >
complex < T > atanh ( const complex < T > & z ) ;
(C++11 이후)

실수축을 따라 구간 [−1; +1] 바깥쪽에 분기 절단을 갖는 z 의 복소수 아크 쌍곡탄젠트를 계산합니다.

목차

매개변수

z - 복소수 값

반환값

오류가 발생하지 않으면, 복소수 쌍곡선 아크 탄젠트 값이 반환됩니다. 이 값은 실수 축을 따라 수학적으로 무한하고 허수 축을 따라 [−iπ/2; +iπ/2] 구간에 있는 반-띠 영역 내에 존재합니다.

오류 처리 및 특수 값

오류는 math_errhandling 과 일관되게 보고됩니다.

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

  • std:: atanh ( std:: conj ( z ) ) == std:: conj ( std:: atanh ( z ) )
  • std:: atanh ( - z ) == - std:: atanh ( z )
  • 만약 z 가 (+0,+0) 이면, 결과는 (+0,+0) 입니다
  • 만약 z 가 (+0,NaN) 이면, 결과는 (+0,NaN) 입니다
  • 만약 z 가 (+1,+0) 이면, 결과는 (+∞,+0) 이며 FE_DIVBYZERO 가 발생합니다
  • 만약 z 가 (x,+∞) (유한한 양의 x에 대해)이면, 결과는 (+0,π/2) 입니다
  • 만약 z 가 (x,NaN) (0이 아닌 유한한 x에 대해)이면, 결과는 (NaN,NaN) 이며 FE_INVALID 가 발생할 수 있습니다
  • 만약 z 가 (+∞,y) (유한한 양의 y에 대해)이면, 결과는 (+0,π/2) 입니다
  • 만약 z 가 (+∞,+∞) 이면, 결과는 (+0,π/2) 입니다
  • 만약 z 가 (+∞,NaN) 이면, 결과는 (+0,NaN) 입니다
  • 만약 z 가 (NaN,y) (유한한 y에 대해)이면, 결과는 (NaN,NaN) 이며 FE_INVALID 가 발생할 수 있습니다
  • 만약 z 가 (NaN,+∞) 이면, 결과는 (±0,π/2) 입니다 (실수부의 부호는 명시되지 않음)
  • 만약 z 가 (NaN,NaN) 이면, 결과는 (NaN,NaN) 입니다

참고 사항

C++ 표준에서는 이 함수를 "complex arc hyperbolic tangent"로 명명하지만, 쌍곡선 함수의 역함수는 면적 함수입니다. 이들의 인수는 호가 아닌 쌍곡선 섹터의 면적입니다. 올바른 명칭은 "complex inverse hyperbolic tangent"이며, 덜 일반적으로 "complex area hyperbolic tangent"라고도 합니다.

역쌍곡탄젠트는 다가 함수이며 복소평면에서 가지 자름이 필요합니다. 가지 자름은 일반적으로 실수축의 선분 (-∞,-1] 과 [+1,+∞) 에 위치합니다.

The mathematical definition of the principal value of the inverse hyperbolic tangent is atanh z =
ln(1+z) - ln(1-z)
2
.
For any z , atanh(z) =
atan(iz)
i
.

예제

이 코드 실행 
#include <complex>
#include <iostream>
int main()
{
    std::cout << std::fixed;
    std::complex<double> z1(2.0, 0.0);
    std::cout << "atanh" << z1 << " = " << std::atanh(z1) << '\n';
    std::complex<double> z2(2.0, -0.0);
    std::cout << "atanh" << z2 << " (the other side of the cut) = "
              << std::atanh(z2) << '\n';
    // for any z, atanh(z) = atanh(iz) / i
    std::complex<double> z3(1.0, 2.0);
    std::complex<double> i(0.0, 1.0);
    std::cout << "atanh" << z3 << " = " << std::atanh(z3) << '\n'
              << "atan" << z3 * i << " / i = " << std::atan(z3 * i) / i << '\n';
}

출력: 

atanh(2.000000,0.000000) = (0.549306,1.570796)
atanh(2.000000,-0.000000) (the other side of the cut) = (0.549306,-1.570796)
atanh(1.000000,2.000000) = (0.173287,1.178097)
atan(-2.000000,1.000000) / i = (0.173287,1.178097)

참고 항목

(C++11)
복소수의 면적 쌍곡사인을 계산합니다 ( arsinh(z) )
(함수 템플릿)
(C++11)
복소수의 면적 쌍곡코사인을 계산합니다 ( arcosh(z) )
(함수 템플릿)
복소수의 쌍곡탄젠트를 계산합니다 ( tanh(z) )
(함수 템플릿)
(C++11) (C++11) (C++11)
역쌍곡탄젠트를 계산합니다 ( artanh(x) )
(함수)
C 문서 for catanh