$coshラジアンで測定された値の双曲線コサインを返します。
$coshの構文は次のとおりです。{ $cosh: <expression> }$coshは、ラジアンで測定された数値に変換される有効な式であればどれでもかまいません。 式が値を度単位で返す場合は、$degreesToRadians演算子を使用して値をラジアンに変換します。デフォルトでは、
$coshは値をdoubleとして返します。$coshでは、<expression>が128ビットの 10 進数値に解決される場合は、 128ビットの 10 進数として値を返すこともできます。式の詳細については、「式 」を参照してください。
動作
null、NaN 、+/- Infinity
入力引数がnullの値に解決されるか、欠落しているフィールドを参照する場合、 $coshはnullを返します。 引数が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")}angleは128ビットの 10 進数として保存されるため、 $coshの出力も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")}angleは128ビットの 10 進数として保存されるため、 $coshの出力も128ビットの 10 進数になります。