PDOStatement::nextRowset
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
Andere Erweiterungen
PHP PDO-Referenzhandbuch