/ /

atanh (표현식 연산자)

$atanh

값의 역쌍곡선 탄젠트(쌍곡선 아크 탄젠트)를 반환합니다.

$atanh 의 구문은 다음과 같습니다:

{ $atanh: <expression> }

$atanh은 -1 ~ 1 사이의 숫자로 해석되는 모든 유효한 표현식 사용합니다(예: -1 <= value <= 1).

$atanh은(는) 라디안 단위의 값을 반환합니다.$radiansToDegrees 연산자 사용하여 출력 값을 라디안에서 각도로 변환합니다.

기본값 으로 $atanh은(는) 값을 double로 반환합니다. $atanh는 <expression>가 128비트 십진수 값으로 해석되는 한 값을 128비트 십진수로 반환할 수도 있습니다.

표현식에 대한 자세한 내용은 표현식을 참조하세요 .

행동

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

인수가 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" : Decimal128("0.5")
}

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

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

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

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

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

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

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

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

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

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

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

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

돌아가기

$atan2

$avg

atanh (표현식 연산자)

행동

null, NaN 및 +/- Infinity

예시

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