mysql.h学习记录

• 简介

简介

mysql.h 是 MySQL C API 的主要头文件，它为 C 开发者提供了一套函数和定义，以与 MySQL 服务器交互。这些函数和定义使得开发者能够编写应用程序，实现与 MySQL 服务器的连接、执行查询、检索结果等操作。

以下是一些常见的函数及其在 mysql.h 中的简要介绍：

1. 连接和关闭

   • mysql_init(MYSQL *mysql): 初始化一个 MYSQL 对象。
   • mysql_real_connect(MYSQL *mysql, const char *host, const char *user, const char *passwd, const char *db, unsigned int port, const char *unix_socket, unsigned long clientflag): 与 MySQL 服务器建立连接。
   • mysql_close(MYSQL *mysql): 关闭一个 MySQL 连接。

2. 执行查询

   • mysql_query(MYSQL *mysql, const char *q): 向服务器发送一个查询。
   • mysql_real_query(MYSQL *mysql, const char *q, unsigned long length): 类似于 mysql_query，但是你可以指定查询字符串的长度。

3. 结果处理

   • mysql_store_result(MYSQL *mysql): 为一个 SELECT 或 SHOW 查询检索完整的结果集。
   • mysql_use_result(MYSQL *mysql): 初始化为逐行检索的结果集。与 mysql_store_result 不同，此方法允许在结果集上启动一个检索，然后在每次调用 mysql_fetch_row() 时检索行，而不会预先检索所有行。
   • mysql_fetch_row(MYSQL_RES *result): 从结果集中获取下一行。
   • mysql_fetch_lengths(MYSQL_RES *result): 返回最近检索的行的每个字段的长度。
   • mysql_free_result(MYSQL_RES *result): 释放一个结果集使用的内存。

4. 错误处理

   • mysql_error(MYSQL *mysql): 返回最近的调用的错误字符串。
   • mysql_errno(MYSQL *mysql): 返回最近的调用的错误编号。

5. 转义和字符串处理

   • mysql_real_escape_string(MYSQL *mysql, char *to, const char *from, unsigned long length): 对字符串进行转义，以便安全地发送到服务器。
   • mysql_escape_string(char *to, const char *from, unsigned long from_length): 这是 mysql_real_escape_string 的旧版本，不再建议使用。

6. 信息检索

   • mysql_num_rows(MYSQL_RES *res): 返回结果集中的行数。
   • mysql_num_fields(MYSQL_RES *res): 返回结果集中的字段数。
   • mysql_field_count(MYSQL *mysql): 返回最近查询的列数。对于 SELECT 查询，这通常是结果集的字段数。

7. 预备语句

   • 还有一些函数支持预备语句，但基本用法主要涉及 mysql_stmt_init、mysql_stmt_prepare、mysql_stmt_execute、mysql_stmt_fetch 和相关函数。这些函数使你能够准备 SQL 语句、绑定参数、执行和检索结果。