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()，它会逐行检索结果，但需要更谨慎地处理，因为它会保持与服务器的连接打开状态，直到结果集被完全读取。
