PHP mysqli_stmt_num_rows() 函数用法及示例

PHP MySQLi 参考手册

mysqli_stmt_num_rows()函数返回语句结果集中的行数。

定义和用法

mysqli_stmt_num_rows()函数接受一个语句对象作为参数,并返回给定语句结果集中的行数。

语法

mysqli_stmt_num_rows($stmt)

参数

序号参数及说明
1

stmt(必需)

这是表示执行SQL查询的语句的对象。

返回值

PHP mysqli_stmt_num_rows()函数返回一个整数值,该值指示该语句返回的结果集中的行数。

PHP版本

此函数最初是在PHP版本5中引入的,并且可以在所有更高版本中使用。

在线示例

以下示例演示了mysqli_stmt_num_rows()函数的用法(面向过程风格)-

<?php
   $con = mysqli_connect("localhost", "root", "password", "mydb");

   mysqli_query($con, "CREATE TABLE Test(Name VARCHAR(255), AGE INT)");
   print("创建表.....\n");
   mysqli_query($con, "insert into Test values('Raju', 25),('Rahman', 30),('Sarmista', 27)");
   print("插入记录.....\n");

   //读取记录
   $stmt = mysqli_prepare($con, "SELECT * FROM Test");

   //执行语句
   mysqli_stmt_execute($stmt);

   mysqli_stmt_store_result($stmt);

   //行数
   $count = mysqli_stmt_num_rows($stmt);

   print("表中的行数: ".$count."\n");

   //结束语句
   mysqli_stmt_close($stmt);

   //关闭连接
   mysqli_close($con);
?>

输出结果

创建表.....
插入记录.....
表中的行数: 3

在线示例

在面向对象风格中,此函数的语法为$con->num_rows;。以下是面向对象风格中此函数的示例;

<?php
   //建立连接
   $con = new mysqli("localhost", "root", "password", "mydb");

   $con -> query("CREATE TABLE Test(Name VARCHAR(255), AGE INT)");
   print("创建表.....\n");
   $con -> query("insert into Test values('Raju', 25),('Rahman', 30),('Sarmista', 27)");
   print("插入记录.....\n");

   $stmt = $con -> prepare( "SELECT * FROM Test");

   //执行语句
   $stmt->execute();

   $stmt->store_result();

   //行数
   $count = $stmt ->num_rows;
   print("表中的行数".$count);

   //结束语句
   $stmt->close();

   //关闭连接
   $con->close();
?>

输出结果

创建表.....
插入记录.....
表中的行数: 3

在线示例

假设我们用下面的数据创建了一个名为cricketers的表;

mysql> select * from cricketers;
+----+------------+------------+---------------+----------------+
| ID | First_Name | Last_Name  | Date_Of_Birth | Place_Of_Birth |
+----+------------+------------+---------------+----------------+
|  1 | Shikhar    | Dhawan     | 1981-12-05    | Delhi          |
|  2 | Jonathan   | Trott      | 1981-04-22    | CapeTown       | 
|  3 | Kumara     | Sangakkara | 1977-10-27    | Matale         |
|  4 | Virat      | Kohli      | 1988-11-05    | Delhi          |
|  5 | Rohit      | Sharma     | 1987-04-30    | Nagpur         |
|  6 | Ravindra   | Jadeja     | 1988-12-06    | Nagpur         |
+----+------------+------------+---------------+----------------+
6 rows in set (0.07 sec)

如果您尝试直接调用这个函数,因为结果还没有存储,则返回0  :

<?php
   $con = mysqli_connect("localhost", "root", "password", "mydb");

   //Reading records
   $stmt = mysqli_prepare($con, "SELECT * FROM cricketers");

   //执行语句
   mysqli_stmt_execute($stmt);

   print("表中的行数: ".mysqli_stmt_num_rows($stmt));

   //结束语句
   mysqli_stmt_close($stmt);

   //关闭连接
   mysqli_close($con);
?>

输出结果

表中的行数: 0

PHP MySQLi 参考手册