/ /

atanh (표현식 연산자)

$atanh

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

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

{ $atanh: <expression> }

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

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

$atanh 기본값 double $atanh 128으로 <expression> 는 값을 로 반환합니다. 는 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

$binarySize

atanh (표현식 연산자)

행동

null, NaN 및 +/- Infinity

예시

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