$slice（聚合）

定义

$slice

返回数组的子集。

注意

消歧

有关在使用 $push 更新期间限制数组大小的信息，请参阅$slice 更新修改器。

有关 find 命令的投影操作符，请参阅 $slice 投影操作符。

$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 个元素。n如果指定了 ，则<position> 无法解析为负数。

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

行为

{ $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 的集合包含以下文档：

db.users.insertMany( [
   { _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" ] }
]