/ /

Expressões

Página inicial do Docs

/ /

Linguagem de query

Expressões

Página inicial do Docs

$cosh (operador de expressão )

$cosh

Retorna o cosseno hiperbólico de um valor medido em radianos.

$cosh tem a seguinte sintaxe:

{ $cosh: <expression> }

$cosh usa qualquerexpressão válida que produza um número, medido em radianos. Se a expressão retornar um valor em graus, utilize o operador $degreesToRadians para converter o valor para radianos.

Por padrão , $cosh retorna valores como double. $cosh também pode retornar valores como um decimal128bits se o <expression> for resolvido para um valor decimal 128bits.

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 retornará null. Se o argumento se resolve em NaN, $cosh retorna NaN. Se o argumento se resolver para Infinity negativo ou positivo, $cosh retornará Infinity positivo.

Exemplo	Resultados
`{ $cosh: NaN }`	`NaN`
`{ $cosh: null }`	`null`
`{ $cosh: -Infinity }`	`Infinity`
`{ $cosh: Infinity }`	`Infinity`

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 $cosh para calcular o cosseno hiperbólico de angle e o adiciona ao documento de entrada utilizando o estágio de pipeline $addFields :

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 decimal128bits, a saída $cosh também é um decimal 128bits.

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 $cosh para calcular o cosseno hiperbólico de angle e o adiciona ao documento de entrada utilizando o estágio de pipeline $addFields :

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 decimal128bits, a saída $cosh também é um decimal 128bits.

Voltar

$cos

$count-acumulador

Comportamento

null, NaN e +/- Infinity

Exemplo

`null`, `NaN` e `+/- Infinity`