Definição
$cosRetorna o cosseno de um valor medido em radianos.
$costem a seguinte sintaxe:{ $cos: <expression> }$cosaceita qualquer expressão válida que seja resolvida para um número. Se a expressão retornar um valor em graus, use o operador$degreesToRadianspara converter o resultado para radianos.Por padrão,
$cosretorna valores comodouble.$costambém pode retornar valores como um decimal de 128 bits, desde que o<expression>resolva para um valor decimal de 128 bits.Para mais informações sobre expressões, consulte Expressões.
Comportamento
null, NaN e +/- Infinity
Se o argumento for resolvido para um valor de null ou se referir a um campo ausente, $cos retornará null. Se o argumento for resolvido em NaN, $cos retornará NaN. Se o argumento for resolvido para infinito negativo ou positivo, $cos lançará um erro.
Exemplo | Resultados |
|---|---|
|
|
|
|
ou
| Lança uma mensagem de erro semelhante à seguinte saída formatada: |
Exemplo
A collection trigonometry contém um documento que armazena a hipotenusa e um ângulo em um triângulo retângulo:
{ "_id" : ObjectId("5c50782193f833234ba90d85"), "angle_a" : Decimal128("53.13010235415597870314438744090659"), "hypotenuse" : Decimal128("5")}A operação de aggregation a seguir usa a expressão $cos para calcular o lado adjacente a angle_a e adicioná-lo ao documento de entrada usando o estágio de pipeline $addFields .
db.trigonometry.aggregate([ { $addFields : { "side_a" : { $multiply : [ { $cos : {$degreesToRadians : "$angle_a"} }, "$hypotenuse" ] } } }])A expressão $degreesToRadians converte o valor do grau de angle_a no valor equivalente em radianos.
O comando retorna a seguinte saída:
{ "_id" : ObjectId("5c50782193f833234ba90d85"), "angle_a" : Decimal128("53.13010235415597870314438744090659"), "side_a" : Decimal128("2.999999999999999999999999999999999"), "hypotenuse" : Decimal128("5"),}Como angle_a e hypotenuse são armazenados como decimais de 128bits, a saída de $cos é um decimal de 128bits.
A collection trigonometry contém um documento que armazena a hipotenusa e um ângulo em um triângulo retângulo:
{ "_id" : ObjectId("5c50782193f833234ba90d85"), "angle_a" : Decimal128("0.9272952180016122324285124629224288"), "hypotenuse" : Decimal128("5")}A operação de aggregation a seguir usa a expressão $cos para calcular o lado adjacente a angle_a e adicioná-lo ao documento de entrada usando o estágio de pipeline $addFields .
db.trigonometry.aggregate([ { $addFields : { "side_b" : { $multiply : [ { $cos : "$angle_a" }, "$hypotenuse" ] } } }])O comando retorna a seguinte saída:
{ "_id" : ObjectId("5c50782193f833234ba90d85"), "angle_a" : Decimal128("0.9272952180016122324285124629224288"), "side_b" : Decimal128("3.000000000000000000000000000000000"), "hypotenuse" : Decimal128("5"),}Como angle_a e hypotenuse são armazenados como decimais de 128bits, a saída de $cos é um decimal de 128bits.