$reverseArray (aggregation)
在本页面
Definition
$reverseArray- 3.4 版的新功能。
接受数组表达式作为参数，并以相反的 Sequences 返回包含元素的数组。
{ $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 }