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（聚合）
$sortArray（聚合） →

在此页面上