$cosh(集計)
$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
を返します。
例 | 結果 |
---|---|
{ $cosh: NaN } | NaN |
{ $cosh: null } | null |
{ $cosh: -Infinity } | Infinity |
{ $cosh: Infinity } | Infinity |
例
次のtrigonometry
コレクションには、度単位で測定されたangle
値を保存するドキュメントが含まれています。
db.trigonometry.insertOne( { "_id" : ObjectId( "5c50782193f833234ba90d85" ), "angle" : NumberDecimal( "53.1301023541559787031443874490659" ) } )
次の集計操作では、 $cosh
式を使用してangle
の双曲線コサインを計算し、それを$addFields
パイプライン ステージを使用して入力ドキュメントに追加します。
db.trigonometry.aggregate( [ { $addFields : { "cosh_output" : { $cosh : { $degreesToRadians : "$angle" } } } } ] )
$degreesToRadians
式は、 angle
を度単位でラジアンに変換します。
出力例:
{ "_id" : ObjectId("5c50782193f833234ba90d85"), "angle" : NumberDecimal("53.1301023541559787031443874490659"), "cosh_output" : NumberDecimal("1.461642741099671277595921778079396") }
angle
は128ビットの 10 進数として保存されるため、 $cosh
の出力も128ビットの 10 進数になります。
次のtrigonometry
コレクションには、ラジアンで測定されたangle
値を保存するドキュメントが含まれています。
db.trigonometry.insertOne( { "_id" : ObjectId( "5c50782193f833234ba90d15" ), "angle" : NumberDecimal( "1.6301023541559787031443874490659" ) } )
次の集計操作では、 $cosh
式を使用してangle
の双曲線コサインを計算し、それを$addFields
パイプライン ステージを使用して入力ドキュメントに追加します。
db.trigonometry.aggregate( [ { $addFields : { "cosh_output" : { $cosh : "$angle" } } } ] )
出力例:
{ "_id" : ObjectId("5c50782193f833234ba90d15"), "angle" : NumberDecimal("1.6301023541559787031443874490659"), "cosh_output" : NumberDecimal("2.650153334504361016712328539738000") }
angle
は128ビットの 10 進数として保存されるため、 $cosh
の出力も128ビットの 10 進数になります。