Docs Menu
Docs Home
/
MongoDB マニュアル
/
参照
/
mongosh メソッド
/
Cursors

cursor.isExhausted()

項目一覧

  • 動作
  • 例
cursor.isExhausted()

重要

mongosh メソッド

これは mongoshメソッドです。 これは、 Node.jsまたはその他のプログラミング言語固有のドライバー メソッドのドキュメントではありません。

ほとんどの場合、 mongoshメソッドはレガシーの mongo shell メソッドと同じように動作します。 ただし、一部のレガシー メソッドはmongoshでは利用できません。

レガシーmongo shell のドキュメントについては、対応する MongoDB Server リリースのドキュメントを参照してください。

MongoDB API ドライバーについては、各言語のMongoDB ドライバードキュメント を参照してください。

次の値を返します。ブール値

カーソルによって読み取られている現在のドキュメント バッチにドキュメントが残っている場合、cursor.isExhausted() は を返します。falseそれ以外の場合、 はtrueを返します。

動作

テール可能カーソル

追尾可能 ( tailable) カーソルでは、 isExhausted()を使用できます。 現在のバッチにドキュメントが残っていない場合でも、追尾可能 (tailable) カーソルは開いたままになります。 ドキュメントがなくなると、他のカーソルは自動的に閉じられます。

変更ストリーム

変更ストリームではisExhausted()は使用できません。 代わりに、次の有無を確認します。

変更ストリームの例については、「監視の例 」を参照してください。

例

このセクションには、カーソルを使用して、気象センサーからの温度読み取り値を持つドキュメントを読み取る例が含まれています。 You'll see examples of isExhausted().

1

コレクションの作成

実行: 

db.sensor.insertMany( [
   { _id: 0, temperature: 12 },
   { _id: 1, temperature: 23 }
] )
2

カーソル変数を作成する

sensorコレクションからドキュメントを読み取るsensorCursorという名前のカーソル変数を作成します。

var sensorCursor = db.sensor.find()
3

カーソル内のドキュメント数をカウントする

実行: 

sensorCursor.count()

コレクションに 2 つのドキュメントがあるため、出力は2です。

4

カーソルから最初のドキュメントを返す

実行: 

sensorCursor.next()

出力: 

{ _id: 0, temperature: 12 }
5

isExhausted()値を調べます

実行: 

sensorCursor.isExhausted()

sensorCursorに残りのドキュメントがあるため、出力はfalseです。

6

カーソルから次のドキュメントを返す

実行: 

sensorCursor.next()

出力: 

{ _id: 1, temperature: 23 }
7

カーソルから次のドキュメントを返そうとする

実行: 

sensorCursor.next()

追加のドキュメントはなく、この例ではnullが返されます。

8

isExhausted()値を調べます

実行: 

sensorCursor.isExhausted()

ドキュメントはなくなり、 isExhausted()はtrueを返します。

戻る

cursor.hint

項目一覧