mysql_store_result() 是 MySQL C API 中的一个函数，用于检索一个完整的结果集到一个客户端。当执行一个查询（通常是 SELECT 查询）并希望处理所有返回的数据时，可以使用此函数。

概念

mysql_store_result() 函数的原型如下：

MYSQL_RES *mysql_store_result(MYSQL *mysql)

• mysql：这是一个指向 MYSQL 结构的指针，该结构代表到一个 MySQL 服务器的连接。
  如果查询成功并返回数据，mysql_store_result() 将返回一个 MYSQL_RES 结构的指针，该结构包含结果集。如果查询没有返回结果集（例如，执行的是 INSERT、UPDATE 或 DELETE 语句），则返回 NULL。如果发生错误，mysql_store_result() 也会返回 NULL，此时可以通过 mysql_error() 函数获取错误信息。

使用案例

以下是一个使用 mysql_store_result() 的例子：

#include <mysql/mysql.h>
#include <stdio.h>
int main() {MYSQL *conn;MYSQL_RES *result;MYSQL_ROW row;unsigned int num_fields;unsigned int i;// 初始化连接conn = mysql_init(NULL);// 连接到数据库if (mysql_real_connect(conn, "host", "user", "password", "database", 0, NULL, 0) == NULL) {fprintf(stderr, "%s\n", mysql_error(conn));mysql_close(conn);exit(1);}// 执行查询if (mysql_query(conn, "SELECT id, name FROM users")) {fprintf(stderr, "%s\n", mysql_error(conn));mysql_close(conn);exit(1);}// 存储结果集result = mysql_store_result(conn);if (result == NULL) {fprintf(stderr, "%s\n", mysql_error(conn));mysql_close(conn);exit(1);}// 获取列数num_fields = mysql_num_fields(result);// 遍历结果集while ((row = mysql_fetch_row(result))) {for (i = 0; i < num_fields; i++) {printf("%s ", row[i] ? row[i] : "NULL");}printf("\n");}// 释放结果集mysql_free_result(result);// 关闭连接mysql_close(conn);return 0;
}

在这个例子中，我们首先连接到 MySQL 数据库，然后执行一个 SELECT 查询。使用 mysql_store_result() 函数将查询结果存储在 result 变量中。然后，我们使用 mysql_num_fields() 函数获取结果集中的列数，并使用 mysql_fetch_row() 函数遍历每一行数据。每行数据都通过 row 变量访问，并打印出来。处理完所有数据后，我们使用 mysql_free_result() 释放结果集，最后关闭数据库连接。
请注意，mysql_store_result() 会将整个结果集加载到客户端内存中，对于非常大的结果集，这可能会导致内存不足的问题。在这种情况下，可以考虑使用 mysql_use_result()，它会逐行检索结果，但需要更谨慎地处理，因为它会保持与服务器的连接打开状态，直到结果集被完全读取。