인수가 null 값으로 해석되거나 누락된 필드를 참조하는 경우 $atanh 는 null 를 반환합니다. 인수가 NaN 으로 확인되면 $atanh 은 NaN 을 반환합니다. 인수가 음수 또는 양수 무한대로 해석되면 $atanh 에서 오류가 발생합니다. 인수가 +1 또는 -1 로 확인되면 $atanh 는 각각 Infinity 및 -Infinity 를 반환합니다.

예시

결과

{ $atanh: NaN }

NaN

{ $atanh: null }

null

{ $atanh: 1 }

Infinity

{ $atanh: -1}

-Infinity

{ $atanh : Infinity}

{ $atanh : -Infinity }

다음과 같은 형식의 출력과 유사한 오류 메시지를 표시합니다.

"errmsg" :
  "Failed to optimize pipeline :: caused by :: cannot
  apply $atanh to -inf, value must in (-inf,inf)"

예시

trigonometry 컬렉션에는 2-D 그래프의 x 축을 따라 값을 저장하는 문서가 포함되어 있습니다.

{
  "_id" : ObjectId("5c50782193f833234ba90d85"),
  "x-coordinate" : NumberDecimal("0.5")
}

다음 애그리게이션 작업은 $atanh 표현식을 사용하여 x-coordinate 의 역쌍곡선 탄젠트를 계산하고 $addFields 파이프라인 단계를 사용하여 입력 문서에 추가합니다.

db.trigonometry.aggregate([
  {
    $addFields : {
      "y-coordinate" : {
        $radiansToDegrees : { $atanh : "$x-coordinate" }
      }
    }
  }
])

$radiansToDegrees 표현식 은 $atanh 에서 반환된 라디안 값을 해당 값(단위: 도)으로 변환합니다.

이 명령은 다음 출력을 반환합니다.

{
  "_id" : ObjectId("5c50782193f833234ba90d85"),
  "x-coordinate" : NumberDecimal("0.5"),
  "y-coordinate" : NumberDecimal("31.47292373094538001977241539068589")
}

x-coordinate 는 128비트 십진수 로 저장되므로 $atanh 의 출력은 128비트 십진수입니다.

trigonometry 컬렉션에는 2-D 그래프의 x 축을 따라 값을 저장하는 문서가 포함되어 있습니다.

{
  "_id" : ObjectId("5c50782193f833234ba90d85"),
  "x-coordinate" : NumberDecimal("0.5")
}

db.trigonometry.aggregate([
  {
    $addFields : {
      "y-coordinate" : {
        $atanh : "$x-coordinate"
      }
    }
  }
])

이 명령은 다음 출력을 반환합니다.

{
  "_id" : ObjectId("5c50782193f833234ba90d85"),
  "x-coordinate" : NumberDecimal("0.5"),
  "y-coordinate" : NumberDecimal("0.5493061443340548456976226184612628")
}

x-coordinate 이(가) 128비트 십진수 로 저장되므로 $asin 의 출력은 128비트 십진수입니다.

돌아가기

$atan2

$avg

행동

null, NaN 및 +/- Infinity

예시

`null`, `NaN` 및 `+/- Infinity`