$addtoset

语法

  1. { $addtoset: { <字段名1>: [ <值1>,<值2>,...,<值N>] ,<字段名2>: [ <值1>,<值2>,...,<值N> ], ... } }

描述

$addtoset是向数组对象中添加元素和值,操作对象必须为数组类型的字段。$addtoset有如下规则:

  • 记录中有指定的字段名(<字段名1>,<字段名2>,…)。

    如果指定的值([<值1>,<值2>,…,<值N>])在记录中存在,跳过不做任何操作,只向目标数组对象中添加不存在的值。

  • 记录中不存在指定的字段名。

    如果记录本身不存在指定的字段名(<字段名1>,<字段名2>,…),那么将指定的字段名和值更新到记录中。

示例

  • 记录中存在目标数组对象。如有记录:

    1. { arr: [1,2,4], age: 10, name: "Tom" }
    1. > db.sample.employee.update({ $addtoset: { arr: [1,3,5] } }, { arr: { $exists: 1 } })

    此操作后,记录更新为:

    1. { arr: [1,2,4,3,5], age: 10, name: "Tom" }

    将原记录arr数组没有的元素3和5,使用$addtoset之后更新到arr数组内。

  • 记录中不存在指定的数组对象,如有记录:

    1. { name: "Mike", age: 12 }
    1. > db.sample.employee.update({ $addtoset: { arr: [1,3,5] } }, { arr: { $exists: 0 } })

    此操作后,记录更新为:

    1. { arr: [1,3,5], age: 12, name: "Mike" }

    原记录中没有数组对象arr字段,$addtoset操作将arr字段和值更新到记录中。