PDOStatement::rowCount

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

PDOStatement::rowCount 返回受上一個(gè) SQL 語(yǔ)句影響的行數(shù)

說(shuō)明

PDOStatement::rowCount(): int

PDOStatement::rowCount() 返回上一個(gè)由對(duì)應(yīng)的 PDOStatement 對(duì)象執(zhí)行DELETE、 INSERT、或 UPDATE 語(yǔ)句受影響的行數(shù)。

如果上一條由相關(guān) PDOStatement 執(zhí)行的 SQL 語(yǔ)句是一條 SELECT 語(yǔ)句,有些數(shù)據(jù)可能返回由此語(yǔ)句返回的行數(shù)。但這種方式不能保證對(duì)所有數(shù)據(jù)有效,且對(duì)于可移植的應(yīng)用不應(yīng)依賴于此方式。

返回值

返回行數(shù)。

范例

示例 #1 返回刪除的行數(shù)

PDOStatement::rowCount() 返回受 DELETE、INSERT、 或 UPDATE 語(yǔ)句影響的行數(shù)。

<?php
/*  從 FRUIT 數(shù)據(jù)表中刪除所有行 */
$del $dbh->prepare('DELETE FROM fruit');
$del->execute();

/*  返回被刪除的行數(shù) */
print("Return number of rows that were deleted:\n");
$count $del->rowCount();
print(
"Deleted $count rows.\n");
?>

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

Return number of rows that were deleted:
Deleted 9 rows.

示例 #2 計(jì)算由一個(gè) SELECT 語(yǔ)句返回的行數(shù)

對(duì)于大多數(shù)數(shù)據(jù)庫(kù),PDOStatement::rowCount() 不能返回受一條 SELECT 語(yǔ)句影響的行數(shù)。替代的方法是,使用 PDO::query() 來(lái)發(fā)出一條和原打算中的SELECT語(yǔ)句有相同條件表達(dá)式的 SELECT COUNT(*) 語(yǔ)句,然后用 PDOStatement::fetchColumn() 來(lái)取得返回的行數(shù)。這樣應(yīng)用程序才能正確執(zhí)行。

<?php
$sql 
"SELECT COUNT(*) FROM fruit WHERE calories > 100";
if (
$res $conn->query($sql)) {

    
/* 檢查符合 SELECT 語(yǔ)句的行數(shù) */
  
if ($res->fetchColumn() > 0) {

        
/* 發(fā)出一條真正的 SELECT 語(yǔ)句并操作返回的結(jié)果 */
         
$sql "SELECT name FROM fruit WHERE calories > 100";
       foreach (
$conn->query($sql) as $row) {
           print 
"Name: " .  $row['NAME'] . "\n";
         }
    }
    
/* 沒(méi)有匹配的行 -- 執(zhí)行其他 */
  
else {
      print 
"No rows matched the query.";
    }
}

$res null;
$conn null;
?>

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

apple
banana
orange
pear

參見(jiàn)