$inc

语法

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

描述

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

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

  • 数值类型,如下例:

    1. { $inc: { age: 1 } }
  • 通过字段操作符指定的原始记录中某数值类型的字段,如下例:

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

    如果 “fieldName” 字段在原始记录中不存在,则不做任何操作;如果存在但不是数值类型,则报错。

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

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

    扩展功能说明:

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

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

示例

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

    1. > db.sample.employee.update({ $inc: { age: 5, ID: 1 } }, { age: { $gt: 15 } })
  • 选择集合 employee 下 age 字段值大于 15 的记录,使用字段 m 的值对 age 字段进行 $inc 操作。

    1. > db.sample.employee.update({ $inc: { age: { $field: "m"} } }, { age: { $gt: 15 } })
  • 选择集合 employee 中存在数组对象 arr 的记录,将数组对象 arr 的第二个元素值添加1。

    1. > db.sample.employee.update({ $inc: { "arr.1": 1 } }, { arr: { $exists: 1 } })
  • 将集合 employee 下 age 字段的值增加 5,并限定增加后的结果必须在 0-100 之间。

    1. > db.sample.employee.update({ $inc: { age: { Value: 5, Min: 0, Max: 100 } } })
  • 在集合 employee 中,使用字段 m 的值对 age 字段进行 $inc 操作,并限定增加后的结果必须在 0-100 之间。

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