$reverseArray(集計)
定義
$reverseArray
バージョン 3.4 で追加。
配列式を引数として受け入れ、要素を逆の順序の配列を返します。
$reverseArray
には次の演算子式の構文があります。{ $reverseArray: <array expression> } 引数は、配列に変換される限り、有効な式であれば何でも使用できます。
動作
引数が null
値に解決されるか、欠落しているフィールドを参照する場合、$reverseArray
は null
を返します。
引数が配列または null
に解決されず、欠落しているフィールドを参照しない場合は、$reverseArray
はエラーを返します。
$reverseArray
引数が空の配列の場合、 は空の配列を返します。
引数にサブ配列が含まれている場合、 $reverseArray
は最上位の配列要素に対してのみ動作し、サブ配列の内容を元に戻すことはありません。
例[1] | 結果 | |||
---|---|---|---|---|
| [ 3, 2, 1 ] | |||
| [ "baz", "bar" ] | |||
| null | |||
| [ ] | |||
| [ [ 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 }