MongoDB\Driver\Cursor::getId
(mongodb >=1.0.0)
MongoDB\Driver\Cursor::getId — Returns the ID for this cursor
説明
final public MongoDB\Driver\Cursor::getId
( void
) : MongoDB\Driver\CursorId
Returns the MongoDB\Driver\CursorId associated with this cursor. A cursor ID uniquely identifies the cursor on the server.
パラメータ
この関数にはパラメータはありません。
返り値
Returns the MongoDB\Driver\CursorId for this cursor.
エラー / 例外
- 引数のパースに失敗した場合に MongoDB\Driver\Exception\InvalidArgumentException をスローします。
例
例1 MongoDB\Driver\Cursor::getId() example
<?php
/* In this example, we insert several documents into the collection and specify
* a smaller batchSize to ensure that the first batch contains only a subset of
* our results and the cursor remains open on the server. */
$manager = new MongoDB\Driver\Manager("mongodb://localhost:27017");
$query = new MongoDB\Driver\Query([], ['batchSize' => 2]);
$bulk = new MongoDB\Driver\BulkWrite;
$bulk->insert(['x' => 1]);
$bulk->insert(['x' => 2]);
$bulk->insert(['x' => 3]);
$manager->executeBulkWrite('db.collection', $bulk);
$cursor = $manager->executeQuery('db.collection', $query);
var_dump($cursor->getId());
?>
上の例の出力は、 たとえば以下のようになります。
object(MongoDB\Driver\CursorId)#5 (1) {
["id"]=>
int(94810124093)
}
参考
- MongoDB\Driver\CursorId
- MongoDB\Driver\CursorId::__toString() - String representation of the cursor ID