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

cursor.isExhausted()

項目一覧

  • 互換性
  • 動作
  • 例
cursor.isExhausted()

重要

mongosh メソッド

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

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

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

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

互換性

このメソッドは、次の環境でホストされている配置で使用できます。

  • MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです

注意

このコマンドは、すべての MongoDB Atlas クラスターでサポートされています。すべてのコマンドに対する Atlas のサポートについては、「サポートされていないコマンド」を参照してください。

  • MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン

  • MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

動作

テール可能カーソル

追尾可能 ( 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

次へ

cursor.itcount

項目一覧