$coshラジアンで測定された値の双曲線コサインを返します。
$coshの構文は次のとおりです。{ $cosh: <expression> } $coshは、ラジアンで測定された数値に変換される任意の有効な式を受け入れます。式が値を度単位で返す場合は、$degreesToRadians演算子を使用して値をラジアンに変換します。デフォルトでは、
$coshdouble$cosh128は値を<expression>128 として返します。 では、 が ビットの 10 進数値に解決される場合は、 ビットの 10 進数として値を返すこともできます。式の詳細については、「式 」を参照してください。
動作
null、NaN 、+/- Infinity
null$coshnull入力引数がNaN の値に解決されるか、欠落しているフィールドを参照する場合、 は$cosh を返します。引数が に解決されると、 はNaN を返します。引数が負の に解決されると、Infinity $coshは正のInfinity を返します。
例 | 結果 |
|---|---|
|
|
|
|
|
|
|
|
例
次のtrigonometryコレクションには、度単位で測定されたangle値を保存するドキュメントが含まれています。
db.trigonometry.insertOne( { "_id" : ObjectId( "5c50782193f833234ba90d85" ), "angle" : Decimal128( "53.1301023541559787031443874490659" ) } )
次の集計操作では、 式を使用して$cosh の双曲線コサインを計算し、それをangle $addFieldsパイプラインステージを使用して入力ドキュメントに追加します。
db.trigonometry.aggregate( [ { $addFields : { "cosh_output" : { $cosh : { $degreesToRadians : "$angle" } } } } ] )
$degreesToRadians式は、 angleを度単位でラジアンに変換します。
出力例:
{ "_id" : ObjectId("5c50782193f833234ba90d85"), "angle" : Decimal128("53.1301023541559787031443874490659"), "cosh_output" : Decimal128("1.461642741099671277595921778079396") }
は angle128ビットの$cosh 10 進数として保存されるため、 の出力も128 ビットの 10 進数になります。
次のtrigonometryコレクションには、ラジアンで測定されたangle値を保存するドキュメントが含まれています。
db.trigonometry.insertOne( { "_id" : ObjectId( "5c50782193f833234ba90d15" ), "angle" : Decimal128( "1.6301023541559787031443874490659" ) } )
次の集計操作では、 式を使用して$cosh の双曲線コサインを計算し、それをangle $addFieldsパイプラインステージを使用して入力ドキュメントに追加します。
db.trigonometry.aggregate( [ { $addFields : { "cosh_output" : { $cosh : "$angle" } } } ] )
出力例:
{ "_id" : ObjectId("5c50782193f833234ba90d15"), "angle" : Decimal128("1.6301023541559787031443874490659"), "cosh_output" : Decimal128("2.650153334504361016712328539738000") }
は angle128ビットの$cosh 10 進数として保存されるため、 の出力も128 ビットの 10 進数になります。