Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# $tanh
<a name="tanh"></a>

Neu ab Version 8.0.1.

Der `$tanh` Operator in Amazon DocumentDB gibt den hyperbolischen Tangens eines Werts zurück.

Der Eingabeausdruck muss in einen numerischen Wert aufgelöst werden.

Der Rückgabetyp ist `double` standardmäßig. Wenn die Eingabe eine 128-Bit-Dezimalzahl ist, ist die Ausgabe ebenfalls eine 128-Bit-Dezimalzahl.

**Parameter**
+ `expression`: Ein Ausdruck, der in eine Zahl aufgelöst wird.

## Behavior
<a name="tanh-behavior"></a>

**Null, NaN und \+/- Unendlich **


| Beispiel | Ergebnisse | 
| --- | --- | 
| { $tanh: NaN } | NaN | 
| { $tanh: null } | null | 
| { $tanh: -Infinity } | -1 | 
| { $tanh: Infinity } | 1 | 

Wenn die Eingabe ist `null` oder das Feld, auf das verwiesen wird, fehlt, wird `$tanh` zurückgegeben`null`. Eine Eingabe von `NaN` erzeugt`NaN`. Für positiv unendlich ist das Ergebnis`1`; für negativ unendlich ist das Ergebnis`-1`.

## Beispiel (MongoDB Shell)
<a name="tanh-examples"></a>

Das folgende Beispiel zeigt, wie der `$tanh` Operator verwendet wird, um den hyperbolischen Tangens eines Werts zu berechnen.

**Erstellen Sie Beispieldokumente **

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

**Beispiel für eine Abfrage **

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

**Ausgabe**

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

## Codebeispiele
<a name="tanh-code"></a>

Um ein Codebeispiel für die Verwendung des `$tanh` Operators anzuzeigen, wählen Sie die Registerkarte für die Sprache, die Sie verwenden möchten:

------
#### [ 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": { $tanh: "$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': { '$tanh': '$value' }
        }}
    ]))

    print(result)
    client.close()

if __name__ == "__main__":
    main()
```

------