문서 메뉴
문서 홈
/
MongoDB 매뉴얼
/
참조
/
연산자
/
집계 파이프라인 연산자

acosh(집계)

이 페이지의 내용

  • 행동
  • 예제
$acosh

값의 역쌍곡선 코사인(쌍곡선 아크 코사인)을 반환합니다.

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

{ $acosh: <expression> }

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

$acosh는 값을 라디안 단위로 반환합니다. 출력 값을 라디안에서 각도로 변환하려면 $radiansToDegrees 연산자를 사용하세요.

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

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

행동

null, NaN 및 +/- Infinity

인수가 null 값으로 해석되거나 누락된 필드를 참조하는 경우 $acosh 은 null을 반환합니다. 인수가 NaN으로 확인되는 경우, $acosh는 NaN을 반환합니다. 인수가 음의 무한대로 해석되면 $acosh에서 오류가 발생합니다. 인수가 Infinity로 해석되면 $acosh는 Infinity을 반환합니다. 인수가 [-1, Infinity] 의 경계를 벗어난 값으로 해석되면 $acosh에서 오류가 발생합니다.

예제
결과
{ $acosh: NaN }
NaN
{ $acosh: null }
null
{ $acosh : Infinity}
Infinity
{ $acosh : 0 }

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

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

예제

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

돌아가기

$acos

다음

$add

이 페이지의 내용