PDOStatement::nextRowset

(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.2.0)

PDOStatement::nextRowset — 在一個(gè)多行集語(yǔ)句句柄中推進(jìn)到下一個(gè)行集

說(shuō)明

PDOStatement::nextRowset(): bool

一些數(shù)據(jù)庫(kù)服務(wù)支持返回一個(gè)以上行集（也被稱(chēng)為結(jié)果集）的存儲(chǔ)過(guò)程。PDOStatement::nextRowset() 使你能夠結(jié)合一個(gè) PDOStatement 對(duì)象訪問(wèn)第二個(gè)以及后續(xù)的行集。上述的每個(gè)行集可以有不同的列集合。

返回值

成功時(shí)返回 true， 或者在失敗時(shí)返回 false。

范例

示例 #1 獲取由一個(gè)存儲(chǔ)過(guò)程返回的多個(gè)行集

下面例子展示了怎樣調(diào)用一個(gè)存儲(chǔ)過(guò)程，返回三個(gè)行集的 MULTIPLE_ROWSETS 。用一個(gè) do / while 循環(huán)來(lái)循環(huán)調(diào)用 PDOStatement::nextRowset() 方法， 當(dāng)不再有行集返回時(shí)返回 false 并結(jié)束循環(huán)。

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

以上例程會(huì)輸出：

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

參見(jiàn)