$coshRetorna o cosseno hiperbólico de um valor medido em radianos.
$coshtem a seguinte sintaxe:{ $cosh: <expression> } $coshpega qualquer expressão válida que resolva um número, medido em radianos. Se a expressão retornar um valor em graus, use o operador para converter o valor para$degreesToRadiansradianos.Por padrão , retorna
$coshvaloresdoublecomo. também pode$cosh128retornar valores como um decimal de bits se o for<expression>resolvido para um 128valor decimal de bits.Para mais informações sobre expressões, consulte Expressões.
Comportamento
null, NaN e +/- Infinity
Se o argumento de entrada for resolvido para um valor de null ou se referir a um campo ausente, $cosh nullretornará. Se o argumento se resolve NaN em, $cosh NaNretorna. Se o argumento se resolver para negativo ou Infinity positivo, $cosh retornará Infinity positivo.
Exemplo | Resultados |
|---|---|
|
|
|
|
|
|
|
|
Exemplo
A seguinte collection do trigonometry contém um documento que armazena um valor do angle medido em graus:
db.trigonometry.insertOne( { "_id" : ObjectId( "5c50782193f833234ba90d85" ), "angle" : Decimal128( "53.1301023541559787031443874490659" ) } )
A seguinte operação de agregação utiliza a expressão para calcular o cosseno hiperbólico $cosh de angle e o adiciona ao documento de entrada $addFields utilizando o estágio de pipeline:
db.trigonometry.aggregate( [ { $addFields : { "cosh_output" : { $cosh : { $degreesToRadians : "$angle" } } } } ] )
A expressão $degreesToRadians converte o angle de graus para radianos.
Saída de exemplo:
{ "_id" : ObjectId("5c50782193f833234ba90d85"), "angle" : Decimal128("53.1301023541559787031443874490659"), "cosh_output" : Decimal128("1.461642741099671277595921778079396") }
Como angle é armazenado como um 128decimal de bits, a saída também é $cosh um 128decimal de bits.
A seguinte coleção trigonometry contém um documento que armazena um valor angle medido em radianos:
db.trigonometry.insertOne( { "_id" : ObjectId( "5c50782193f833234ba90d15" ), "angle" : Decimal128( "1.6301023541559787031443874490659" ) } )
A seguinte operação de agregação utiliza a expressão para calcular o cosseno hiperbólico $cosh de angle e o adiciona ao documento de entrada $addFields utilizando o estágio de pipeline:
db.trigonometry.aggregate( [ { $addFields : { "cosh_output" : { $cosh : "$angle" } } } ] )
Saída de exemplo:
{ "_id" : ObjectId("5c50782193f833234ba90d15"), "angle" : Decimal128("1.6301023541559787031443874490659"), "cosh_output" : Decimal128("2.650153334504361016712328539738000") }
Como angle é armazenado como um 128decimal de bits, a saída também é $cosh um 128decimal de bits.