MongoCommandCursor::rewind

(PECL mongo >=1.5.0)

MongoCommandCursor::rewind — Ejecuta el comando y reinicia el cursor al comienzo del conjunto de resultados

Descripción

public MongoCommandCursor::rewind ( void ) : array

Si el cursor ya a empezado a iterar, el comando será reejecutado.

Parámetros

Esta función no tiene parámetros.

Valores devueltos

El documento resultante sin tratar.

Errores/Excepciones

Lanza una MongoConnectionException si no puede conectar a la base de datos, y una MongoCursorTimeoutException si se excede el tiempo de espera.

Lanza una MongoCursorException si el cursor se creó con MongoCommandCursor::createFromDocument() y ya se ha iniciado la iteración. Tales cursores no se pueden iterar varias veces, ya que carecen del comando original necesario para la reejecución.

Ejemplos

Ejemplo #1 MongoCommandCursor::rewind()

<?php
$rawResult = $commandCursor->rewind();

// El cursor del comando ahora se reinicia al principio del conjunto de resultados

var_dump($rawResult);
?>

El resultado del ejemplo sería algo similar a:

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)
}

Ver también