Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.

$tanh (operador de expressão )

$tanh

Retorna a tangente hiperbólica de um valor medido em radianos.

$tanh tem a seguinte sintaxe:

{ $tanh: <expression> }

$tanh pega qualquer expressão válida que resolva 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 , $tanh retorna valores como double. $tanh 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.

Se o argumento de entrada for resolvido para um valor de null ou se referir a um campo ausente, $tanh retornará null. Se o argumento se resolve em NaN, $tanh retorna NaN. Se o argumento se resolver para Infinity negativo ou positivo, $tanh retornará -1 ou 1 respectivamente.

Exemplo
Resultados

{ $tanh: NaN }

NaN

{ $tanh: null }

null

{ $tanh: -Infinity }

-1

{ $tanh: Infinity }

1

A seguinte collection do trigonometry contém um documento que armazena um valor do angle medido em graus:

db.trigonometry.insertOne( { "_id" : ObjectId( "5c50782193f833234ba90d45" ), "angle" : Decimal128( "53.1301023541559787031443874490659" ) })

A seguinte operação de agregação utiliza a expressão $tanh para calcular a tangente hiperbólica de angle e a adiciona ao documento de entrada utilizando o estágio de pipeline $addFields :

db.trigonometry.aggregate( [ { $addFields : { "tanh_output" : { $tanh : { $degreesToRadians : "$angle" } } } }] )

A expressão $degreesToRadians converte o angle de graus para radianos.

Saída de exemplo:

{ "_id" : ObjectId("5c50782193f833234ba90d45"), "angle" : Decimal128("53.1301023541559787031443874490659"), "tanh_output" : Decimal128("0.7293303448445332820512777329448416")}

Como angle é armazenado como um decimal128bits, a saída $tanh também é um decimal 128bits.

Avalie esta página