$slice (aggregation)
在本页面
Definition
$slice- 3.2 版中的新功能。
返回数组的子集。
$slice具有以下两种语法形式之一：
以下语法从数组的开头或结尾返回元素：
{ $slice: [ <array>, <n> ] }
以下语法从数组中的指定位置返回元素：
{ $slice: [ <array>, <position>, <n> ] }
| Operand | Description |
|---|---|
<array> |
任何有效的expression，只要它解析为数组即可。 |
<position> |
可选的。任何有效的expression，只要它解析为整数即可。 |
如果为正，则$slice从数组的开始确定开始位置。如果<position>大于元素数，则$slice返回一个空数组。
如果为负，则$slice确定从数组末尾开始的位置。如果<position>的绝对值大于元素数，则开始位置是数组的开始。
| <n> |任何有效的expression，只要它解析为整数即可。如果指定了<position>，则<n>必须解析为正整数。
如果为正，则$slice返回数组中的前n个元素。如果指定了<position>，则$slice返回从该位置开始的前n个元素。
如果为负，则$slice返回数组中的最后n个元素。 n无法解析为负数如果 <position>被指定。
有关表达式的更多信息，请参见Expressions。
Behavior
| Example | Results |
|---|---|
{ $slice: [ [ 1, 2, 3 ], 1, 1 ] } |
[ 2 ] |
{ $slice: [ [ 1, 2, 3 ], -2 ] } |
[ 2, 3 ] |
{ $slice: [ [ 1, 2, 3 ], 15, 2 ] } |
[ ] |
{ $slice: [ [ 1, 2, 3 ], -15, 2 ] } |
[ 1, 2 ] |
Example
名为users的集合包含以下文档：
{ "_id" : 1, "name" : "dave123", favorites: [ "chocolate", "cake", "butter", "apples" ] }
{ "_id" : 2, "name" : "li", favorites: [ "apples", "pudding", "pie" ] }
{ "_id" : 3, "name" : "ahn", favorites: [ "pears", "pecans", "chocolate", "cherries" ] }
{ "_id" : 4, "name" : "ty", favorites: [ "ice cream" ] }
下面的示例为每个用户最多返回favorites数组中的前三个元素：
db.users.aggregate([
{ $project: { name: 1, threeFavorites: { $slice: [ "$favorites", 3 ] } } }
])
该操作返回以下结果：
{ "_id" : 1, "name" : "dave123", "threeFavorites" : [ "chocolate", "cake", "butter" ] }
{ "_id" : 2, "name" : "li", "threeFavorites" : [ "apples", "pudding", "pie" ] }
{ "_id" : 3, "name" : "ahn", "threeFavorites" : [ "pears", "pecans", "chocolate" ] }
{ "_id" : 4, "name" : "ty", "threeFavorites" : [ "ice cream" ] }