$inc

语法

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

描述

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

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

  • 数值类型，如下例：
  1. { $inc: { age: 1 } }
  • 对象类型，支持扩展功能，如下例：
  1. { $inc: { age: { Value: 1, Default:1, Min: 1, Max: 150} } }

扩展功能说明：

字段名功能是否必填说明Value指定需要增加的值是只能为数值类型Default当需要做inc操作的字段不存在时，取该值作为该字段的值否可以为数值类型或null，不填时默认值为 0；指定为 null 时表示当字段不存在时不做操作。Min指定inc操作之后结果的最小值否只能为数值类型Max指定inc操作之后结果的最大值否只能为数值类型

示例

  • 选择集合bar下age字段值大于15的记录，然后更新这些记录，将age字段的值增加5、ID 的值添加1。
  1. > db.foo.bar.update({ $inc: { age: 5, ID: 1 } }, { age: { $gt: 15 } })
  • 选择集合bar中存在数组对象arr的记录，将数组对象arr的第二个元素值添加1。
  1. > db.foo.bar.update({ $inc: { "arr.1": 1 } }, { arr: { $exists: 1 } })
  • 将集合bar下age字段的值增加5，并限定增加后的结果必须在0-100之间。
  1. > db.foo.bar.update({ $inc: { age: { Value: 5, Min: 0, Max: 100 } } })