PDOStatement::nextRowset

PHP PDO 参考手册PHP PDO-Referenzhandbuch

PDOStatement::nextRowset — Rückt zum nächsten Rowset in einem Multi-Rowset-Statement-Handle vor (PHP 5 >= 5.1.0, PECL pdo >= 0.2.0)


Beschreibung

Syntax

bool PDOStatement::nextRowset ( void )

Einige Datenbankserver unterstützen gespeicherte Prozeduren, die mehr als eine Ergebnismenge (auch als Resultset bekannt) zurückgeben.

PDOStatement::nextRowset() ermöglicht den Zugriff auf die zweite und alle nachfolgenden Ergebnismengen, die einem PDOStatement-Objekt zugeordnet sind. Jede dieser Ergebnismengen kann eine andere Spaltenmenge haben.


Rückgabewerte

Gibt bei Erfolg TRUE zurück, bei Fehlschlag FALSE.


Beispiele

Mehrere von einer gespeicherten Prozedur zurückgegebene Ergebnismengen abrufen

Das folgende Beispiel zeigt, wie eine gespeicherte Prozedur namens MULTIPLE_ROWSETS aufgerufen wird, die drei Ergebnismengen zurückgibt. Verwenden Sie eine do/while-Schleife, um wiederholt die Methode PDOStatement::nextRowset() aufzurufen, die false zurückgibt und die Schleife beendet, wenn keine weiteren Ergebnismengen zurückgegeben werden.

<?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";
}
?>

Das obige Beispiel gibt aus:

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 参考手册PHP PDO-Referenzhandbuch

Andere Erweiterungen