mysql.h函数详解

1. 连接相关函数

(1) mysql_init()

MYSQL *mysql_init(MYSQL *mysql)

说明：初始化MYSQL数据结构，返回MYSQL指针。

参数说明：

mysql：MYSQL结构体指针变量。

返回值说明：成功时返回指向MYSQL结构体的指针，失败时返回NULL，并设置错误号（通过mysql_errno()获取）。

(2) mysql_real_connect()

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：MYSQL结构体指针变量。

host：MySQL服务器名称或IP地址。

user：登录MySQL服务器的用户名。

passwd：登录MySQL服务器的密码。

db：要连接的数据库名称。

port：MySQL服务器端口号。

unix_socket：UNIX套接字文件路径。

clientflag：客户端标志位。

返回值说明：成功时返回指向MYSQL结构体的指针，失败时返回NULL，并设置错误号（通过mysql_errno()获取）。

(3) mysql_close()

void mysql_close(MYSQL *mysql)

说明：关闭MySQL服务器连接。

参数说明：

mysql：MYSQL结构体指针变量。

返回值说明：无返回值。

2. 执行SQL语句相关函数

(1) mysql_query()

int mysql_query(MYSQL *mysql, const char *stmt_str)

说明：执行一条SQL查询语句或更新语句。

参数说明：

mysql：MYSQL结构体指针变量。

stmt_str：要执行的SQL语句字符串。

返回值说明：成功时返回0，失败时返回非0错误代码（通过mysql_errno()获取）。

(2) mysql_real_query()

int mysql_real_query(MYSQL *mysql, const char *stmt_str, unsigned long length)

说明：执行一条SQL查询语句或更新语句。

参数说明：

mysql：MYSQL结构体指针变量。

stmt_str：要执行的SQL语句字符串。

length：SQL语句长度。

返回值说明：成功时返回0，失败时返回非0错误代码（通过mysql_errno()获取）。

(3) mysql_store_result()

MYSQL_RES *mysql_store_result(MYSQL *mysql)

说明：将查询结果集保存在客户端内存中。

参数说明：

mysql：MYSQL结构体指针变量。

返回值说明：成功时返回一个MYSQL_RES结构体指针，失败时返回NULL，并设置错误号（通过mysql_errno()获取）。

(4) mysql_use_result()

MYSQL_RES *mysql_use_result(MYSQL *mysql)

说明：逐行获取查询结果集。

参数说明：

mysql：MYSQL结构体指针变量。

返回值说明：成功时返回一个MYSQL_RES结构体指针，失败时返回NULL，并设置错误号（通过mysql_errno()获取）。

3. 结果集相关函数

(1) mysql_fetch_row()

MYSQL_ROW mysql_fetch_row(MYSQL_RES *result)

说明：逐行获取查询结果集，并返回一个MYSQL_ROW结构体指针。

参数说明：

result：MYSQL_RES结构体指针变量。

返回值说明：成功时返回一个MYSQL_ROW结构体指针，失败时返回NULL。

(2) mysql_num_rows()

unsigned long mysql_num_rows(MYSQL_RES *result)

说明：获取查询结果集中的行数。

参数说明：

result：MYSQL_RES结构体指针变量。

返回值说明：成功时返回查询结果集中行的数量，失败时返回0。

(3) mysql_num_fields()

unsigned int mysql_num_fields(MYSQL_RES *result)

说明：获取查询结果集中的列数。

参数说明：

result：MYSQL_RES结构体指针变量。

返回值说明：成功时返回查询结果集中列的数量，失败时返回0。

(4) mysql_field_count()

unsigned int mysql_field_count(MYSQL *mysql)

说明：获取最近一次执行的SQL语句所返回的列数。

参数说明：

mysql：MYSQL结构体指针变量。

返回值说明：成功时返回最近一次执行的SQL语句所返回的列数，失败时返回0。

4. 错误处理相关函数

(1) mysql_errno()

unsigned int mysql_errno(MYSQL *mysql)

说明：获取最近一次操作失败的错误代码。

参数说明：

mysql：MYSQL结构体指针变量。

返回值说明：返回最近一次操作失败的错误代码。

(2) mysql_error()

const char *mysql_error(MYSQL *mysql)

说明：获取最近一次操作失败的错误信息。

参数说明：

mysql：MYSQL结构体指针变量。

返回值说明：返回最近一次操作失败的错误信息。

5. 事务处理相关函数

(1) mysql_autocommit()

my_bool mysql_autocommit(MYSQL *mysql, my_bool mode)

说明：设置是否默认支持事务处理，如果设置为0，则表示关闭事务自动提交。

参数说明：

mysql：MYSQL结构体指针变量。

mode：设置事务自动提交的运作模式。如果 mode 的值为 0，表示禁止自动提交模式，否则表示启用自动提交模式。

返回值说明：成功时返回一个非零值，失败时返回0，并设置错误号（通过mysql_errno()获取）。

(2) mysql_commit()

int mysql_commit(MYSQL *mysql)

说明：提交事务处理。

参数说明：

mysql：MYSQL结构体指针变量。

返回值说明：成功时返回0，失败时返回非0错误代码（通过mysql_errno()获取）。

(3) mysql_rollback()

int mysql_rollback(MYSQL *mysql)

说明：回滚事务处理。

参数说明：

mysql：MYSQL结构体指针变量。

返回值说明：成功时返回0，失败时返回非0错误代码（通过mysql_errno()获取）。

6. 其他函数

(1) mysql_list_dbs()

`int mysql_list_dbs(MYSQL *mysql, const char *wild)

说明：获取服务器上的所有数据库。

参数说明：

mysql：MYSQL结构体指针变量。

wild：数据库名称的模式字符串。

返回值说明：成功时返回0，失败时返回非0错误代码（通过mysql_errno()获取）。

(2) mysql_get_server_info()

const char *mysql_get_server_info(MYSQL *mysql)

说明：获取服务器版本信息。

参数说明：

mysql：MYSQL结构体指针变量。

返回值说明：成功时返回服务器版本信息字符串，失败时返回NULL。

(3) mysql_character_set_name()

const char *mysql_character_set_name(MYSQL *mysql)

说明：获取服务器默认字符集名称。

参数说明：

mysql：MYSQL结构体指针变量。

返回值说明：成功时返回服务器默认字符集名称字符串，失败时返回NULL。