$position

項目一覧

定義

動作
例

定義

$position

$position修飾子は、配列内で $push演算子が要素を挿入するロケーションを指定します。 $position修飾子がない場合、 $push演算子は配列の末尾に要素を挿入します。詳細については、「 $push 修飾子」を参照してください。

$position修飾子を使用するには、修飾子と一緒に使用する必要 $eachがあります。

{
  $push: {
    <field>: {
       $each: [ <value1>, <value2>, ... ],
       $position: <num>
    }
  }
}

<num> ゼロベースの配列インデックス（位置）に基づいて、配列内の位置を示します。

負でない数は、配列の先頭から始まる配列内の位置に対応します。 <num>の値が配列の長さ以上の場合、 $position修飾子は効果がなく、 $pushは配列の末尾に要素を追加します。
負の数は、配列の最終要素から数えた（ただし最後の要素は含まない）配列内の位置に対応します。たとえば、-1 は配列の最終要素の直前の位置を示します。$each 配列に複数の要素を指定した場合、最後に追加された要素は末尾から指定された位置に配置されます。<num> の絶対値が配列の長さ以上の場合、$push は配列の先頭に要素を追加します。

動作

MongoDB 5.0 以降、更新演算子では名前が文字列ベースのドキュメントフィールドを辞書順に処理します。数値名のフィールドは、数値順に処理されます。詳細については、「更新演算子の動作」を参照してください。

例

配列の先頭に要素を追加する

students コレクションを次のように作成します。

db.students.insertOne( { "_id" : 1, "scores" : [ 100 ] } )

次の操作では、scores フィールドをアップデートして、要素 50、60、70 を配列の先頭に追加します。

db.students.updateOne(
   { _id: 1 },
   {
     $push: {
        scores: {
           $each: [ 50, 60, 70 ],
           $position: 0
        }
     }
   }
)

この操作により、次のドキュメントが更新されます。

{ "_id" : 1, "scores" : [  50,  60,  70,  100 ] }

配列の中央に要素を追加する

students コレクションにドキュメントを追加します。

db.students.insertOne( { "_id" : 2, "scores" : [  50,  60,  70,  100 ] } )

次の操作では、scores フィールドを更新して 2 の配列インデックス（位置）に要素 20 と 30 を追加します。

db.students.updateOne(
   { _id: 2 },
   {
     $push: {
        scores: {
           $each: [ 20, 30 ],
           $position: 2
        }
     }
   }
)

この操作により、次のドキュメントが更新されます。

{ "_id" : 2, "scores" : [  50,  60,  20,  30,  70,  100 ] }

負の配列インデックス（位置）を使って配列に要素を追加する

$positionは、配列の最終要素から数えて（ただし最後の要素は含まない）、末尾から始まる位置を示すために負の配列インデックス（位置）値を受け入れることができます。たとえば、 -1は配列の最終要素の直前の位置を示します。

次のドキュメントを students コレクションに追加します。

db.students.insertOne(
   { "_id" : 3, "scores" : [  50,  60,  20,  30,  70,  100 ] }
)

次の演算では、$position に -2 を指定して、最後の要素の 2 つ前の位置に 90 を追加し、最後の要素の 2 つ前の位置に 80 を追加します。

重要

配列のインデックス（位置）が負の場合、$each 配列に複数の要素を指定すると、最後に追加された要素は末尾から指定された位置に配置されます。

db.students.updateOne(
   { _id: 3 },
   {
     $push: {
        scores: {
           $each: [ 90, 80 ],
           $position: -2
        }
     }
   }
)

この操作により、次のドキュメントが更新されます。

{ "_id" : 3, "scores" : [ 50, 60, 20, 30, 90, 80, 70, 100 ] }

戻る

$each

$slice