PDOStatement::rowCount

PHP PDO 参考手册PHP PDO リファレンスマニュアル

PDOStatement::rowCount — 直前の SQL ステートメントによって影響を受けた行数を返す(PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)


説明

構文

int PDOStatement::rowCount ( void )

PDOStatement::rowCount() は、対応する PDOStatement オブジェクトによって実行された DELETE、INSERT、または UPDATE ステートメントによって影響を受けた行数を返します。

関連する PDOStatement によって実行された最後の SQL ステートメントが SELECT ステートメントである場合、一部のデータベースでは、そのステートメントによって返された行数を返すことがあります。ただし、この方法はすべてのデータベースで有効であるとは限らず、移植可能なアプリケーションではこの方法に依存すべきではありません。


戻り値

行数を返します。


例

削除された行数を返す

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.

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

PHP PDO 参考手册PHP PDO リファレンスマニュアル

その他の拡張機能