Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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

`$inc`Operator digunakan untuk menambah nilai bidang dengan jumlah tertentu. Ini digunakan untuk memperbarui bidang numerik, seperti penghitung atau peringkat, tanpa harus mengambil nilai saat ini, menghitung nilai baru, dan kemudian memperbarui bidang.

**Parameter**
+ `field`: Nama bidang untuk kenaikan.
+ `amount`: Jumlah yang digunakan untuk menambah bidang. Ini bisa menjadi nilai positif atau negatif.

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

Contoh berikut menunjukkan bagaimana menggunakan `$inc` operator untuk menambah `age` bidang dokumen.

**Buat dokumen sampel**

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

**Contoh kueri**

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

**Lihat dokumen yang diperbarui**

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

**Keluaran**

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

## Contoh kode
<a name="inc-code"></a>

Untuk melihat contoh kode untuk menggunakan `$inc` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:

------
#### [ 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()
```

------