Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# \$1 en INT
<a name="toInt"></a>

Nouveau depuis la version 4.0

L'`$toInt`opérateur dans Amazon DocumentDB est utilisé pour convertir une valeur d'entrée en un type de données entier. Cet opérateur est utile lorsque vous devez vous assurer qu'un champ ou une expression est représenté sous la forme d'un entier, ce qui peut être important pour certaines opérations ou tâches de traitement de données.

**Paramètres**
+ `expression`: expression à convertir en entier.

## Exemple (MongoDB Shell)
<a name="toInt-examples"></a>

L'exemple suivant montre comment utiliser l'`$toInt`opérateur pour convertir une valeur de chaîne en entier.

**Création d'exemples de documents**

```
db.numbers.insertMany([
  { "name": "one", "value": "1" },
  { "name": "hundred", "value": "100" }
]);
```

**Exemple de requête**

```
db.numbers.aggregate([
  { $project: {
    "_id": 0,
    "name": 1,
    "intValue": { $toInt: "$value" }
  }}
]);
```

**Sortie**

```
{ "name": "one", "intValue": 1 }
{ "name": "hundred", "intValue": 100 }
```

## Exemples de code
<a name="toInt-code"></a>

Pour afficher un exemple de code d'utilisation de la `$toInt` commande, choisissez l'onglet correspondant à la langue que vous souhaitez utiliser :

------
#### [ Node.js ]

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

async function example() {
  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('numbers');

  const result = await collection.aggregate([
    { $project: {
      "_id": 0,
      "name": 1,
      "intValue": { $toInt: "$value" }
    }}
  ]).toArray();

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

example();
```

------
#### [ Python ]

```
from pymongo import MongoClient

def example():
    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['numbers']

    result = list(collection.aggregate([
        { "$project": {
            "_id": 0,
            "name": 1,
            "intValue": { "$toInt": "$value" }
        }}
    ]))

    print(result)
    client.close()

example()
```

------