PDOStatement::nextRowset
PDOStatement::nextRowset — Passe à l'ensemble de lignes suivant dans un descripteur d'instruction à plusieurs ensembles de lignes (PHP 5 >= 5.1.0, PECL pdo >= 0.2.0)
Description
Syntaxe
bool PDOStatement::nextRowset ( void )
Certains serveurs de bases de données prennent en charge des procédures stockées qui renvoient plus d'un jeu de lignes (également appelé jeu de résultats).
PDOStatement::nextRowset() vous permet d'accéder au deuxième jeu de lignes et aux suivants associés à un objet PDOStatement. Chacun de ces jeux de lignes peut avoir un ensemble de colonnes différent.
Valeurs de retour
Retourne TRUE en cas de succès, ou FALSE en cas d'échec.
Exemples
Récupérer plusieurs jeux de lignes renvoyés par une procédure stockée
L'exemple suivant montre comment appeler une procédure stockée, MULTIPLE_ROWSETS, qui renvoie trois jeux de lignes. Utilisez une boucle do/while pour appeler de façon répétée la méthode PDOStatement::nextRowset(), qui renvoie false et met fin à la boucle lorsqu'il n'y a plus de jeux de lignes renvoyés.
<?php
$sql = 'CALL multiple_rowsets()';
$stmt = $conn->query($sql);
$i = 1;
do {
$rowset = $stmt->fetchAll(PDO::FETCH_NUM);
if ($rowset) {
printResultSet($rowset, $i);
}
$i++;
} while ($stmt->nextRowset());
function printResultSet(&$rowset, $i) {
print "Result set $i:\n";
foreach ($rowset as $row) {
foreach ($row as $col) {
print $col . "\t";
}
print "\n";
}
print "\n";
}
?>
L'exemple ci-dessus produit :
Result set 1: apple red banana yellow Result set 2: orange orange 150 banana yellow 175 Result set 3: lime green apple red banana yellow
Autres extensions
Manuel de référence PHP PDO