PDOStatement::rowCount
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 リファレンスマニュアル