$reverseArray (aggregation)

在本页面

• Definition

• Behavior

• Example

Definition

• $reverseArray
  • 3.4 版的新功能。

接受数组表达式作为参数，并以相反的 Sequences 返回包含元素的数组。

$reverseArray具有以下运算符表达式语法：

{ $reverseArray: <array expression> }

该参数可以是任何有效的expression，只要它解析为数组即可。

Behavior

如果参数解析为null的值或引用缺少的字段，则$reverseArray返回null。

如果参数不解析为数组或null，也没有引用缺少的字段，则$reverseArray返回错误。

当参数为空数组时，$reverseArray返回一个空数组。

如果参数包含子数组，则$reverseArray仅对顶级数组元素进行操作，而不会反转子数组的内容。

Example [1]	Results
{ $reverseArray: { $literal: [ 1, 2, 3 ] } }	[ 3, 2, 1 ]
{ $reverseArray:
{ $slice: [ [ “ foo”，“ bar”，“ baz”，“ qux”], 1, 2 ] } } }	[ "baz", "bar" ]
{ $reverseArray: null }	null
{ $reverseArray: { $literal: [ ] } }	[ ]
{ $reverseArray: { $literal: [ [ 1, 2, 3 ], [ 4, 5, 6 ] ] } }	[ [ 4, 5, 6 ], [ 1, 2, 3 ] ]

[1]	表中的示例采用 Literals 参数。为了避免在 Literals 参数是数组的情况下解析歧义，您必须将 Literals 数组包装在$literal表达式中或保留指定参数列表的外部数组(例如[ [ 1, 2, 3 ] ])以传递 Literals 数组[1, 2, 3]。

Example

名为users的集合包含以下文档：

{ "_id" : 1, "name" : "dave123", "favorites" : [ "chocolate", "cake", "butter", "apples" ] }
{ "_id" : 2, "name" : "li", "favorites" : [ "apples", "pudding", "pie" ] }
{ "_id" : 3, "name" : "ahn", "favorites" : [ ] }
{ "_id" : 4, "name" : "ty" }

下面的示例以相反的 Sequences 返回包含favorites数组的元素的数组：

db.users.aggregate([
   {
     $project:
      {
         name: 1,
         reverseFavorites: { $reverseArray: "$favorites" }
      }
   }
])

该操作返回以下结果：

{ "_id" : 1, "name" : "dave123", "reverseFavorites" : [ "apples", "butter", "cake", "chocolate" ] }
{ "_id" : 2, "name" : "li", "reverseFavorites" : [ "pie", "pudding", "apples" ] }
{ "_id" : 3, "name" : "ahn", "reverseFavorites" : [ ] }
{ "_id" : 4, "name" : "ty", "reverseFavorites" : null }