(PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)
PDOStatement::rowCount — 返回受上一個 SQL 語句影響的行數
說明
int PDOStatement::rowCount ( void )PDOStatement::rowCount() 返回上一個由對應的 PDOStatement 對象執行DELETE、 INSERT、或 UPDATE 語句受影響的行數。
如果上一條由相關 PDOStatement 執行的 SQL 語句是一條 SELECT 語句,有些數據可能返回由此語句返回的行數。但這種方式不能保證對所有數據有效,且對於可移植的應用不應依賴於此方式。
返回值
返回行數。
範例
Example #1 返回刪除的行數
PDOStatement::rowCount() 返回受 DELETE、INSERT、 或 UPDATE 語句影響的行數。
<?php
/* 從 FRUIT 數據表中刪除所有行 */
$del = $dbh->prepare('DELETE FROM fruit');
$del->execute();
/* 返回被刪除的行數 */
print("Return number of rows that were deleted:n");
$count = $del->rowCount();
print("Deleted $count rows.n");
?>
以上例程會輸出:
Return number of rows that were deleted:
Deleted 9 rows.
Example #2 計算由一個 SELECT 語句返回的行數
對於大多數數據庫,PDOStatement::rowCount() 不能返回受一條 SELECT 語句影響的行數。替代的方法是,使用 PDO::query() 來發出一條和原打算中的SELECT語句有相同條件表達式的 SELECT COUNT(*) 語句,然後用 PDOStatement::fetchColumn() 來取得返回的行數。這樣應用程序才能正確執行。
<?php
$sql = "SELECT COUNT(*) FROM fruit WHERE calories > 100";
if ($res = $conn->query($sql)) {
/* 檢查符合 SELECT 語句的行數 */
if ($res->fetchColumn() > 0) {
/* 發出一條真正的 SELECT 語句並操作返回的結果 */
$sql = "SELECT name FROM fruit WHERE calories > 100";
foreach ($conn->query($sql) as $row) {
print "Name: " . $row['NAME'] . "n";
}
}
/* 沒有匹配的行 -- 執行其他 */
else {
print "No rows matched the query.";
}
}
$res = null;
$conn = null;
?>
以上例程會輸出:
apple
banana
orange
pear
參見
PDOStatement::columnCount() - 返回結果集中的列數 PDOStatement::fetchColumn() - 從結果集中的下一行返回單獨的一列。 PDO::query() - Executes an SQL statement, returning a result set as a PDOStatement object
PHP:PDOStatement::nextRowset()方法參數說明
PDOStatement::nextRowset(PHP5=5.1.0,PECLpdo=0.2.0)PDOStatement::nextRowset在一個多行集語句句柄中推進到下一個行集說明boolPDOStatement::nextRowset(void)一些數據庫服務支持
PHP:PDOStatement::getColumnMeta()方法參數說明
PDOStatement::getColumnMeta(PHP5=5.1.0,PECLpdo=0.2.0)PDOStatement::getColumnMeta返回結果集中一列的元數據說明arrayPDOStatement::getColumnMeta(int$column)Warning此函數是實驗性的。
PHP:PDOStatement::getAttribute()方法參數說明
PDOStatement::getAttribute(PHP5=5.1.0,PECLpdo=0.2.0)PDOStatement::getAttribute檢索一個語句屬性說明mixedPDOStatement::getAttribute(int$attribute)得到語句的一個屬性。當前,不存