Docs Menu
Docs Home
/
MongoDB マニュアル
/ / /

$slice(集計)

項目一覧

  • 定義
  • 動作
$slice

バージョン 3.2 で追加

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

$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 という名前のコレクションには次のドキュメントが含まれています。

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

戻る

$sinh

項目一覧