PDOStatement::nextRowset

PHP PDO 参考手册Manuel de référence PHP PDO

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

PHP PDO 参考手册Manuel de référence PHP PDO

Autres extensions