PHP MySQLi 函数

PHP mysqli_result::$num_rows / mysqli_num_rows() 函数用于获取结果中的行数

mysqli_num_rows() 的行为取决于是否使用缓冲或非缓冲结果集。对于未缓冲的结果集,此函数返回 0,除非已从服务器获取所有行。

语法

//面向对象风格
$mysqli_result->num_rows;

//面向过程风格
mysqli_num_rows(result)

参数

结果 必填。 仅适用于面向过程风格:指定 mysqli_query()、mysqli_store_result()、mysqli_use_result() 或 mysqli_stmt_get_result() 返回的 mysqli_result 对象。

返回值

返回一个 int 表示所获取的行数。在无缓冲模式下返回 0,除非已从服务器获取所有行。

注意:如果行数大于 PHP_INT_MAX,则该数字将为以字符串形式返回。

示例:面向对象风格

下面的示例显示了mysqli_result::$num_rows属性的用法。

<?php
//建立与数据库的连接
$mysqli = new mysqli("localhost", "user", "password", "database");
if ($mysqli->connect_errno) {
  echo "Failed to connect to MySQL: ". $mysqli->connect_error;
  exit();
}

//从数据库获取查询结果
$sql = "SELECT EmpID, Name, Age FROM Employee ORDER BY Age";
$result = $mysqli->query($sql);

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

//获取结果集中的行数
$row_cnt = $result->num_rows;
printf("Result set has %d rows.\n", $row_cnt);
?>

上述代码的输出将类似于:

Result set has 58 rows.

示例:面向过程风格

下面的示例显示mysqli_num_rows()的用法 函数。

<?php
//建立与数据库的连接
$mysqli = mysqli_connect("localhost", "user", "password", "database");
if (mysqli_connect_errno()) {
  echo "Failed to connect to MySQL: ". mysqli_connect_error();
  exit();
}

//从数据库获取查询结果
$sql = "SELECT EmpID, Name, Age FROM Employee ORDER BY Age";
$result = mysqli_query($mysqli, $sql);

//关闭连接
mysqli_close($mysqli);

//获取结果集中的行数
$row_cnt = mysqli_num_rows($result);
printf("Result set has %d rows.\n", $row_cnt);
?>

上述代码的输出将类似于:

Result set has 58 rows.