Docs 菜单
Docs 主页
/
MongoDB Manual
/
聚合操作
/
参考
/
操作符

$slice（聚合）

在此页面上

  • 定义
  • 行为
  • 例子

定义

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

{ "_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

在此页面上