$inc

语法

{ $inc: { <字段名1>: <值1>, <字段名2>: <值2>, ... } }

描述

$inc 操作是给指定“<字段名>”增加指定的“<值>”。如果原记录中没有指定的字段名，则将字段名和值填充到记录中；如果原记录中存在指定的字段名，则将字段名的值加上指定的值。

其中“<值>”支持以下几种格式：

• 数值类型

  { $inc: { age: 1 } }

• 通过字段操作符指定的原始记录中某数值类型的字段

  { $inc: { age: { $field: "fieldName" } } }

  Note:

  对于使用字段操作符的方式，如果 fieldName 字段在原始记录中不存在，则不做任何操作；如果存在但不是数值类型，则报错。

• 对象类型，支持扩展功能，其中在 Value 字段的值中，也可以使用字段操作符

  { $inc: { age: { Value: 1, Default:1, Min: 1, Max: 150} } }
  { $inc: { age: { Value: { $field: "fieldName" }, Default:1, Min: 1, Max: 150} } }

  扩展功能说明：

  字段名	描述	是否必填
  Value	指定需要增加的值 只能为数值类型或通过 "$field" 指定的原始记录中数值类型的字段	是
  Default	当需要做inc操作的字段不存在时，取该值作为该字段的值 可以为数值类型或null，不填时默认值为 0；指定为 null 时表示当字段不存在时不做操作	否
  Min	指定inc操作之后结果的最小值 只能为数值类型	否
  Max	指定inc操作之后结果的最大值 只能为数值类型	否

示例

• 选择集合 employee 下 age 字段值大于 15 的记录，然后更新这些记录，将 age 字段的值增加5、ID 的值添加1。

  > db.sample.employee.update({ $inc: { age: 5, ID: 1 } }, { age: { $gt: 15 } })

• 选择集合 sample.employee 下 age 字段值大于 15 的记录，使用字段 m 的值对 age 字段进行 $inc 操作

  > db.sample.employee.update({ $inc: { age: { $field: "m"} } }, { age: { $gt: 15 } })

• 选择集合 sample.employee 中存在数组对象 arr 的记录，将数组对象 arr 的第二个元素值加 1

  > db.sample.employee.update({ $inc: { "arr.1": 1 } }, { arr: { $exists: 1 } })

• 将集合 sample.employee 下 age 字段的值加 5，并限定增加后的结果必须在 0~100 之间

  > db.sample.employee.update({ $inc: { age: { Value: 5, Min: 0, Max: 100 } } })

• 在集合 sample.employee 中，使用字段 m 的值对 age 字段进行 $inc 操作，并限定增加后的结果必须在 0~100 之间

  > db.sample.employee.update({ $inc: { age: { Value: { $field: "m" }, Min: 0, Max: 100 } } })