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