$reverseArray（集計）

項目一覧

定義

動作
例

定義

$reverseArray

バージョン 3.4 で追加。

配列式を引数として受け入れ、要素を逆の順序の配列を返します。

$reverseArrayには次の演算子式の構文があります。

{ $reverseArray: <array expression> }

引数は、配列に変換される限り、有効な式であれば何でも使用できます。

動作

引数が null 値に解決されるか、欠落しているフィールドを参照する場合、$reverseArray は null を返します。

引数が配列または null に解決されず、欠落しているフィールドを参照しない場合は、$reverseArray はエラーを返します。

$reverseArray 引数が空の配列の場合、は空の配列を返します。

引数にサブ配列が含まれている場合、 $reverseArrayは最上位の配列要素に対してのみ動作し、サブ配列の内容を元に戻すことはありません。

例[1]

結果

{ $reverseArray: { $literal: [ 1, 2, 3 ] } }

[ 3, 2, 1 ]

{ $reverseArray:
   { $slice:  [ [ "foo", "bar", "baz", "qux" ], 1, 2 ] } }
}

[ "baz", "bar" ]

{ $reverseArray: null }

null

{ $reverseArray: { $literal: [ ] } }

[ ]

{ $reverseArray: { $literal: [ [ 1, 2, 3 ], [ 4, 5, 6 ] ] } }

[ [ 4, 5, 6 ], [ 1, 2, 3 ] ]

[1]	表の例はリテラル引数を受け取ります。リテラル引数が配列の場合の解析のあいまいさを避けるには、リテラル配列を`$literal`式でラップするか、引数リストを指定する外側の配列を保持する必要があります（例: `[ [ 1, 2, 3 ] ]` ）をリテラル配列`[1, 2, 3]`で渡します。

例

users という名前のコレクションには次のドキュメントが含まれています。

{ "_id" : 1, "name" : "dave123", "favorites" : [ "chocolate", "cake", "butter", "apples" ] }
{ "_id" : 2, "name" : "li", "favorites" : [ "apples", "pudding", "pie" ] }
{ "_id" : 3, "name" : "ahn", "favorites" : [ ] }
{ "_id" : 4, "name" : "ty" }

次の例では、 favorites配列の要素を逆の順序で含む配列を返します。

db.users.aggregate([
   {
     $project:
      {
         name: 1,
         reverseFavorites: { $reverseArray: "$favorites" }
      }
   }
])

この操作は次の結果を返します。

{ "_id" : 1, "name" : "dave123", "reverseFavorites" : [ "apples", "butter", "cake", "chocolate" ] }
{ "_id" : 2, "name" : "li", "reverseFavorites" : [ "pie", "pudding", "apples" ] }
{ "_id" : 3, "name" : "ahn", "reverseFavorites" : [ ] }
{ "_id" : 4, "name" : "ty", "reverseFavorites" : null }

戻る

$replaceAll

$round