$slice（式演算子）

定義

$slice

配列のサブセットを返します。

注意

曖昧さ回避

$push を使用した更新中に配列のサイズを制限する方法については、この項目ではなく $slice 更新修飾子を参照してください。

find コマンドのプロジェクション演算子については、代わりに $slice プロジェクション演算子を参照してください。

$slice 次の 2 つの構文形式のいずれかがあります。

次の構文は、配列の先頭または末尾から要素を返します。

{ $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 配列の最初の 3 つの要素が返されます。

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