MongoCommandCursor::rewind

(PECL mongo >=1.5.0)

MongoCommandCursor::rewind — Exécute la commande, et replace le curseur au début du jeu de résultats

Description

public array MongoCommandCursor::rewind ( void )

Si le curseur a commencé son itération, la commande sera ré-exécutée.

Liste de paramètres

Cette fonction ne contient aucun paramètre.

Valeurs de retour

Le document brute servi par le serveur.

Erreurs / Exceptions

Lance une exception MongoConnectionException si la base de données ne peut être atteinte et une exception MongoCursorTimeoutException si le délai d'attente maximal a été atteint.

Lance une exception MongoCursorException si le curseur a été créé avec la méthode MongoCommandCursor::createFromDocument() et que l'itération a déjà commencé. De tels curseurs ne peuvent être parcourus à plusieurs reprises, sachant qu'ils perdent la commande originale nécessaire à la ré-exécution.

Exemples

Exemple #1 Exemple avec MongoCommandCursor::rewind()

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

// Le curseur de commande est maintenant ré-initialisé au début du jeu de résultats

var_dump($rawResult);
?>

L'exemple ci-dessus va afficher quelque chose de similaire à :

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

Voir aussi