(PHP 5, PHP 7, PHP 8)
mysqli_stmt::$num_rows -- mysqli_stmt::num_rows -- mysqli_stmt_num_rows — 返回从服务器获取的行数
面向对象风格
过程化风格
返回在语句中缓冲的行数。此函数仅在调用 mysqli_stmt_store_result() 将整个结果集缓冲到语句句柄中之后才能工作。
除非从服务器获取了所有行，否则此函数返回 0。
示例 #1 面向对象风格
<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
$query = "SELECT Name, CountryCode FROM City ORDER BY Name LIMIT 20";
$stmt = $mysqli->prepare($query);
$stmt->execute();
/* 将结果存储到内部缓冲区中 */
$stmt->store_result();
printf("Number of rows: %d.\n", $stmt->num_rows);示例 #2 过程化风格
<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$link = mysqli_connect("localhost", "my_user", "my_password", "world");
$query = "SELECT Name, CountryCode FROM City ORDER BY Name LIMIT 20";
$stmt = mysqli_prepare($link, $query);
mysqli_stmt_execute($stmt);
/* 将结果存储到内部缓冲区中 */
mysqli_stmt_store_result($stmt);
printf("Number of rows: %d.\n", mysqli_stmt_num_rows($stmt));以上示例将输出
Number of rows: 20.
请注意，对于有时错过阅读此函数的重要手册条目的人员
如果您不使用 mysqli_stmt_store_result( )，并在执行预处理语句后立即调用此函数，则此函数通常会返回 0，因为它无法知道结果集中有多少行，因为结果集尚未保存在内存中。
mysqli_stmt_store_result( ) 将结果集保存在内存中，因此您可以在执行语句和保存结果集后立即使用此函数。
如果您不保存结果集但仍想使用此函数，则必须使用 mysqli_stmt_fetch( ) 逐行遍历结果集，然后才能使用此函数确定行数。
不过，如果您想在不存储结果集并在遍历结果集后确定行数，为什么不简单地在循环中每次获取一行时都使用内部计数器，并保存函数调用呢？
简而言之，此函数仅在您保存结果集并希望在遍历结果集之前确定行数时才真正有用，否则您可以像我建议的那样重现其用途。