$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 个元素。如果指定了 <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 的集合包含以下文档：

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" ] }
]