$acos값의 역코사인(아크 코사인)을 반환합니다.
$acos의 구문은 다음과 같습니다:{ $acos: <expression> } $acos은-1에서1사이의 숫자로 해석되는 유효한 표현식 을 사용합니다.-1 <= value <= 1.$acos는 값을 라디안 단위로 반환합니다. 출력 값을 라디안에서 각도로 변환하려면$radiansToDegrees연산자를 사용하세요.기본적으로
$acos값은double로 반환합니다.$acos는<expression>이 128-비트 십진수 값으로 확인되는 한 값을 128-비트 십진수로 반환할 수도 있습니다.표현식에 대한 자세한 내용은 표현식을 참조하세요 .
행동
인수가 null 값으로 확인되거나 누락된 필드를 참조하는 경우 $acos는 null을 반환합니다. 인수가 NaN으로 확인되는 경우 $acos는 NaN을 반환합니다. 인수가 [-1, 1] 범위를 벗어난 값으로 확인되는 경우 $acos는 오류를 발생시킵니다.
예시 | 결과 | |||
|---|---|---|---|---|
|
| |||
|
| |||
or
| 다음과 같은 형식의 출력과 유사한 오류 메시지를 표시합니다. |
예시
trigonometry 컬렉션에는 직각 삼각형의 세 변을 저장하는 문서가 포함되어 있습니다.
{ "_id" : ObjectId("5c50782193f833234ba90d85"), "side_a" : Decimal128("3"), "side_b" : Decimal128("4"), "hypotenuse" : Decimal128("5") }
다음 집계 작업은 $acos 표현식 을 사용하여 side_a 에 인접한 각도를 계산하고 $addFields 파이프라인 단계를 사용하여 입력 문서 에 추가합니다.
db.trigonometry.aggregate([ { $addFields : { "angle_a" : { $radiansToDegrees : { $acos : { $divide : [ "$side_b", "$hypotenuse" ] } } } } } ])
$radiansToDegrees 표현식 은 $acos 에서 반환된 라디안 값을 해당 값(단위: 도)으로 변환합니다.
이 명령은 다음 출력을 반환합니다.
{ "_id" : ObjectId("5c50782193f833234ba90d85"), "side_a" : Decimal128("3"), "side_b" : Decimal128("4"), "hypotenuse" : Decimal128("5"), "angle_a" : Decimal128("36.86989764584402129685561255909341") }
side_b와 hypotenuse은 128-비트 십진수로 저장되므로 $acos의 출력은 128-비트 십진수입니다.
trigonometry 컬렉션에는 직각 삼각형의 세 변을 저장하는 문서가 포함되어 있습니다.
{ "_id" : ObjectId("5c50782193f833234ba90d85"), "side_a" : Decimal128("3"), "side_b" : Decimal128("4"), "hypotenuse" : Decimal128("5") }
다음 집계 작업은 $acos 표현식 을 사용하여 side_a 에 인접한 각도를 계산하고 $addFields 파이프라인 단계를 사용하여 입력 문서 에 추가합니다.
db.trigonometry.aggregate([ { $addFields : { "angle_a" : { $acos : { $divide : [ "$side_b", "$hypotenuse" ] } } } } ])
이 명령은 다음 출력을 반환합니다.
{ "_id" : ObjectId("5c50782193f833234ba90d85"), "side_a" : Decimal128("3"), "side_b" : Decimal128("4"), "hypotenuse" : Decimal128("5"), "angle_a" : Decimal128("0.6435011087932843868028092287173226") }
side_b와 hypotenuse은 128-비트 십진수로 저장되므로 $acos의 출력은 128-비트 십진수입니다.