pdostatement::rowcount-凯发官网入口

pdostatement::rowcount

(php 5 >= 5.1.0, php 7, php 8, pecl pdo >= 0.1.0)

pdostatement::rowcount — 返回受上一个 sql 语句影响的行数  

说明

pdostatement::rowcount(): int

pdostatement::rowcount() 返回上一个由对应的 pdostatement 对象执行delete、 insert、或 update 语句受影响的行数。

如果上一条由相关 pdostatement 执行的 sql 语句是一条 select 语句，有些数据可能返回由此语句返回的行数。但这种方式不能保证对所有数据有效，且对于可移植的应用不应依赖于此方式。

返回值

返回行数。

范例

example #1 返回删除的行数

pdostatement::rowcount() 返回受 delete、insert、 或 update 语句影响的行数。

/*  从 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() 来取得返回的行数。这样应用程序才能正确执行。

$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