Docs Menu

/

MongoDBマニュアル

/

/

mongosh メソッド

/

cursor.isExhausted()

項目一覧

動作

例

cursor.isExhausted()

重要

mongosh メソッド

このページでは、 mongosh メソッドが文書化されます。これは Node.js などの言語固有のドライバーのドキュメントではありません。

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

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

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

動作

テール可能カーソル

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

変更ストリーム

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

ドキュメントが変更ストリームカーソル内に残っている場合は、 cursor.tryNext()を使用します。
変更ストリームカーソルが閉じている場合は、 cursor.isClosed()を使用します。

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

例

このセクションには、カーソルを使用して、気象センサーからの温度読み取り値を持つドキュメントを読み取る例が含まれています。 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

次へ

cursor.itcount

項目一覧

動作
例