$atanh

Nouveau depuis la version 8.0.1.

L'$atanhopérateur dans Amazon DocumentDB renvoie la tangente hyperbolique inverse (tangente à l'arc hyperbolique) d'une valeur.

L'expression d'entrée doit être résolue en un nombre compris entre -1 0 et 1 (inclus). Les valeurs situées en dehors de cette plage génèrent une erreur.

Le type de retour est double par défaut. Si l'entrée est une décimale de 128 bits, la sortie est également une décimale de 128 bits.

Paramètres

• expression: expression qui se résout par un nombre compris entre -1 et1, inclus.

Comportement

null, NaN et +/- Infinity

Exemple	Résultats
{ $atanh: NaN }	NaN
{ $atanh: null }	null
{ $atanh: 1 }	Infinity
{ $atanh: -1 }	-Infinity
{ $atanh: Infinity } ou { $atanh: -Infinity }	Génère une erreur.

Lorsque l'entrée est nulle null ou que le champ référencé est absent, le résultat estnull. Une entrée de NaN produitsNaN. Les valeurs limites 1 et le -1 produit Infinity et-Infinity, respectivement. Toute valeur en dehors de la [-1, 1] plage (y compris±Infinity) provoque une erreur.

Exemple (MongoDB Shell)

L'exemple suivant montre comment utiliser l'$atanhopérateur pour calculer la tangente hyperbolique inverse d'une valeur.

Créez des exemples de documents

db.values.insertMany([
  { "_id": 1, "value": 0 },
  { "_id": 2, "value": 0.5 },
  { "_id": 3, "value": -0.5 }
]);

Exemple de requête

db.values.aggregate([
  { $project: {
    "result": { $atanh: "$value" }
  }}
]);

Sortie

[
  { "_id": 1, "result": 0 },
  { "_id": 2, "result": 0.5493061443340548 },
  { "_id": 3, "result": -0.5493061443340548 }
]

Exemples de code

Pour afficher un exemple de code d'utilisation de l'$atanhopérateur, choisissez l'onglet correspondant à la langue que vous souhaitez utiliser :

Node.js

const { MongoClient } = require('mongodb');

async function main() {
  const client = await MongoClient.connect('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
  const db = client.db('test');
  const collection = db.collection('values');

  const result = await collection.aggregate([
    { $project: {
      "result": { $atanh: "$value" }
    }}
  ]).toArray();

  console.log(result);
  await client.close();
}

main();

Python

from pymongo import MongoClient

def main():
    client = MongoClient('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
    db = client['test']
    collection = db['values']

    result = list(collection.aggregate([
        { '$project': {
            'result': { '$atanh': '$value' }
        }}
    ]))

    print(result)
    client.close()

if __name__ == "__main__":
    main()