MongoCommandCursor::rewind
(PECL mongo >=1.5.0)
MongoCommandCursor::rewind — Executes the command and resets the cursor to the start of the result set
説明
public array MongoCommandCursor::rewind
( void
)
If the cursor has already started iteration, the command will be re-executed.
パラメータ
この関数にはパラメータはありません。
返り値
The raw server result document.
エラー / 例外
Throws MongoConnectionException if it cannot reach the database and MongoCursorTimeoutException if the timeout is exceeded.
Throws MongoCursorException if the cursor was created with MongoCommandCursor::createFromDocument() and has already started iteration. Such cursors cannot be iterated multiple times, as they lack the original command necessary for re-execution.
例
例1 MongoCommandCursor::rewind()
<?php
$rawResult = $commandCursor->rewind();
// Command cursor is now reset to the start of the result set
var_dump($rawResult);
?>
上の例の出力は、 たとえば以下のようになります。
array(2) {
["cursor"]=>
array(3) {
["id"]=>
object(MongoInt64)#5 (1) {
["value"]=>
string(12) "310050110216"
}
["ns"]=>
string(9) "demo.test"
["firstBatch"]=>
array(1) {
[0]=>
array(2) {
["_id"]=>
object(MongoId)#6 (1) {
["$id"]=>
string(24) "52f5691544670a8077b0dc51"
}
["value"]=>
string(2) "42"
}
}
}
["ok"]=>
float(1)
}
参考
- Iterator::rewind() - イテレータの最初の要素に巻き戻す
忘却曲線を使ってこの知識を確実に記憶に残す
