$slice（聚合）

在此页面上

定义

行为
例子

定义

$slice

版本 3.2 中的新增功能。

返回数组的子集。

$slice 具有以下两种语法形式：

以下语法会从数组的开头或结尾返回元素：

{ $slice: [ <array>, <n> ] }

以下语法会从数组中的指定位置返回元素：

{ $slice: [ <array>, <position>, <n> ] }

操作数	说明
`<array>`	任何有效的表达式，只要它能解析为一个数组。
`<position>`	可选。任何有效表达式，只要其解析为整数。如果为正数，`$slice` 将决定从数组起始位置算起的起始位置。如果 `<position>` 大于元素数量，`$slice` 则返回空数组。如果为负数，`$slice` 将决定从数组末尾开始的起始位置。如果 `<position>` 的绝对值大于元素数，则起始位置为数组的开头。
`<n>`	任何有效表达式，只要其解析为整数。如果指定了 `<position>`，则`<n>` 必须解析为正整数。如果为正数，`$slice` 最多返回数组中的前 `n` 个元素。如果指定了 `<position>`，则 `$slice` 返回从该位置开始的前 `n` 个元素。如果为负数，`$slice` 最多会返回数组中的最后 `n` 个元素。如果指定了 `<position>`，`n` 则无法解析为负数。

有关表达式的更多信息，请参阅表达式。

行为

例子

结果

{ $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 ]

例子

一个名为 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" ] }

后退

$sinh

来年

$split