本文将会介绍如何在 update() 方法中使用 $inc 操作符增加指定字段的值。

$inc 操作符

有时候我们需要增加文档中某些字段的值， $inc 操作符可以实现这个功能。

$inc 操作符的语法如下：

{ $inc: {<field1>: <amount1>, <field2>: <amount2>, ...} }

其中，amount 可以是正数或者负数。正数表示增加字段的值，负数表示减少字段的值。

如果指定的字段不存在，$inc 操作符将会创建并设置该字段的值。

$inc 示例

我们将会使用以下集合进行演示：

db.products.insertMany([
    { "_id" : 1, "name" : "xPhone", "price" : 799, "releaseDate": ISODate("2011-05-14"), "spec" : { "ram" : 4, "screen" : 6.5, "cpu" : 2.66 },"color":["white","black"],"storage":[64,128,256]},
    { "_id" : 2, "name" : "xTablet", "price" : 899, "releaseDate": ISODate("2011-09-01") , "spec" : { "ram" : 16, "screen" : 9.5, "cpu" : 3.66 },"color":["white","black","purple"],"storage":[128,256,512]},
    { "_id" : 3, "name" : "SmartTablet", "price" : 899, "releaseDate": ISODate("2015-01-14"), "spec" : { "ram" : 12, "screen" : 9.7, "cpu" : 3.66 },"color":["blue"],"storage":[16,64,128]},
    { "_id" : 4, "name" : "SmartPad", "price" : 699, "releaseDate": ISODate("2020-05-14"),"spec" : { "ram" : 8, "screen" : 9.7, "cpu" : 1.66 },"color":["white","orange","gold","gray"],"storage":[128,256,1024]},
    { "_id" : 5, "name" : "SmartPhone", "price" : 599,"releaseDate": ISODate("2022-09-14"), "spec" : { "ram" : 4, "screen" : 5.7, "cpu" : 1.66 },"color":["white","orange","gold","gray"],"storage":[128,256]}
 ])

示例一：增加指定字段的值

以下示例使用 $inc 操作符将 products 集合中文档（_id: 1）的 price 字段的值增加 50：

db.products.updateOne({
    _id: 1
}, {
    $inc: {
        price: 50
    }
})

返回结果如下：

{
  acknowledged: true,
  insertedId: null,
  matchedCount: 1,
  modifiedCount: 1,
  upsertedCount: 0
}

再次查询该文档，可以看到价格的变化：

db.products.find(
    {_id: 1},
    {name: 1, price: 1}
)

[ { _id: 1, name: 'xPhone', price: 849 } ]

示例二：减少指定字段的值

下面的示例使用 $inc 操作符将文档（_id: 1）中的 price 字段的值减少 150：

db.products.updateOne({
    _id: 1
}, {
    $inc: {
        price: -150
    }
})

返回结果如下：

{
  acknowledged: true,
  insertedId: null,
  matchedCount: 1,
  modifiedCount: 1,
  upsertedCount: 0
}

再次查询该产品的价格：

db.products.find(
    { _id: 1 },
    { name: 1, price: 1 }
)

[ { _id: 1, name: 'xPhone', price: 699 } ]

示例三：更新多个字段的值

以下示例使用 $inc 操作符更新了嵌入式文档 spec 中的 price 字段和 ram 字段的值：

db.products.updateOne({
    _id: 1
}, {
    $inc: {
        price: 50,
        "spec.ram": 4
    }
})

输出结果如下：

{
  acknowledged: true,
  insertedId: null,
  matchedCount: 1,
  modifiedCount: 1,
  upsertedCount: 0
}

再次查询该文档，验证更新后的结果：

db.products.find(
    {_id: 1},
    {name: 1, price: 1, "spec.ram": 1}
)

[ { _id: 1, name: 'xPhone', price: 749, spec: { ram: 8 } } ]