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.
错误/异常
- Throws MongoDB\Driver\Exception\InvalidArgumentException on argument parsing errors.
范例
Example #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