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.

# \$1inc
<a name="inc"></a>

L'`$inc`opérateur est utilisé pour incrémenter la valeur d'un champ d'un montant spécifié. Il est utilisé pour mettre à jour un champ numérique, tel qu'un compteur ou une évaluation, sans avoir à récupérer la valeur actuelle, à calculer la nouvelle valeur, puis à mettre à jour le champ.

**Paramètres**
+ `field`: nom du champ à incrémenter.
+ `amount`: montant par lequel le champ doit être incrémenté. Il peut s'agir d'une valeur positive ou négative.

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

L'exemple suivant montre comment utiliser l'`$inc`opérateur pour incrémenter le `age` champ d'un document.

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

```
db.users.insertOne({_id: 123, name: "John Doe", age: 30})
```

**Exemple de requête**

```
db.users.updateOne({_id: 123}, {$inc: {age: 1}})
```

**Afficher le document mis à jour**

```
db.users.findOne({_id: 123})
```

**Sortie**

```
{ "_id" : 123, "name" : "John Doe", "age" : 31 }
```

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

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

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

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

async function updateWithInc() {
  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('users');

  const result = await collection.updateOne(
    { _id: 123 },
    { $inc: { age: 1 } }
  );

  console.log(result);

  await client.close();
}

updateWithInc();
```

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

```
from pymongo import MongoClient

def update_with_inc():
    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['users']

    result = collection.update_one(
        {'_id': 123},
        {'$inc': {'age': 1}}
    )

    print(result.modified_count)

    client.close()

update_with_inc()
```

------