PHP MySQLi 函数

PHP mysqli::use_result() / mysqli_use_result() 函数用于启动结果集的检索从数据库连接上使用 mysqli_real_query() 函数执行的最后一个查询开始。

在检索查询结果之前，必须调用此函数或 mysqli_store_result() 函数，并且必须调用其中之一被调用以防止该数据库连接上的下一个查询失败。

注意:此函数不会从数据库传输整个结果集，因此不能可以使用 mysqli_data_seek() 等函数移动到集合中的特定行。要使用此功能，必须使用 mysqli_store_result() 存储结果集。如果在客户端执行大量处理，则不应使用 mysqli_use_result()，因为这会占用服务器并阻止其他线程更新从中获取数据的任何表。

语法

//面向对象风格
public mysqli::use_result()

//面向过程风格
mysqli_use_result()

参数

无需参数。

返回值

返回无缓冲的结果对象，如果发生错误，则返回 false。

示例:面向对象风格

下面的示例显示了 mysqli 的用法: :use_result() 方法。

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

//包含多个查询的字符串
$sql = "SELECT CURRENT_USER();";
$sql .= "SELECT Name FROM Employee";

//执行多个查询
$mysqli->multi_query($sql);
do {
  //存储第一个结果集
  if ($result = $mysqli->use_result()) {
    while ($row = $result->fetch_row()) {
      printf("%s\n", $row[0]);
    }
    $result->close();
  }

  //如果有更多结果集，则打印分隔符
  if ($mysqli->more_results()) {
    printf("--------------\n");
  }
} while ($mysqli->next_result());

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

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

user@localhost
--------------
Marry
Kim
John
Adam

示例:面向过程风格

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

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

//包含多个查询的字符串
$sql = "SELECT CURRENT_USER();";
$sql .= "SELECT Name FROM Employee";

//执行多个查询
mysqli_multi_query($mysqli, $sql);
do {
  //存储第一个结果集
  if ($result = mysqli_use_result($mysqli)) {
    while ($row = mysqli_fetch_row($result)) {
      printf("%s\n", $row[0]);
    }
    mysqli_free_result($result);
  }
  
  //如果有更多结果集，则打印分隔符
  if (mysqli_more_results($mysqli)) {
    printf("--------------\n");
  }
} while (mysqli_next_result($mysqli));

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

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

user@localhost
--------------
Marry
Kim
John
Adam