MySQL -- MySQL Connection C中的API介绍

文章目录

[MySQL -- MySQL Connection C中的API介绍](#MySQL -- MySQL Connection C中的API介绍)
一、接口介绍
- 1.初始化mysql_init()
- [2. 链接数据库mysql_real_connect](#2. 链接数据库mysql_real_connect)
- 3.下发mysql命令mysql_query
- 4.获取执行结果mysql_store_result
- 5.获取结果行数和列数
- 6.获取列名mysql_fetch_fields
- 7.获取结果内容mysql_fetch_row
- 8.释放结果空间mysql_free_result
- 9.关闭mysql链接mysql_close

一、接口介绍

1.初始化mysql_init()

cpp 复制代码

MYSQL *mysql_init(MYSQL *mysql);

如：

cpp 复制代码

MYSQL *mfp = mysql_init(NULL)

2. 链接数据库mysql_real_connect

初始化完毕之后，必须先链接数据库，在进行后续操作。（mysql网络部分是基于TCP/IP的）

cpp 复制代码

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);

建立好链接之后，获取英文没有问题，如果获取中文是乱码：
设置链接的默认字符集是utf8，原始默认是latin1；

cpp 复制代码

mysql_set_character_set(myfd, "utf8");

第一个参数 MYSQL是 C api中一个非常重要的变量（mysql_init的返回值），里面内存非常丰富，有port,dbname,charset等连接基本参数。它也包含了一个叫 st_mysql_methods的结构体变量，该变量里面保存着很多函数指针，这些函数指针将会在数据库连接成功以后的各种数据操作中被调用。mysql_real_connect函数中各参数，基本都是顾名思意。

3.下发mysql命令mysql_query

cpp 复制代码

int mysql_query(MYSQL *mysql, const char *q);

第一个参数上面已经介绍过，第二个参数为要执行的sql语句,如"select * from table"。

4.获取执行结果mysql_store_result

sql执行完以后，如果是查询语句，我们当然还要读取数据，如果update，insert等语句，那么就看下操作成功与否即可。我们来看看如何获取查询结果：如果mysql_query返回成功，那么我们就通过mysql_store_result这个函数来读取结果。原型如下：

cpp 复制代码

MYSQL_RES *mysql_store_result(MYSQL *mysql);

该函数会调用MYSQL变量中st_mysql_methods中的 read_rows 函数指针来获取查询的结果。同时该函数会返回MYSQL_RES 这样一个变量，该变量主要用于保存查询的结果。同时该函数malloc了一片内存空间来存储查询过来的数据，所以我们一定要记的 mysql_free_result(result),不然是肯定会造成内存泄漏的。执行完mysql_store_result以后，其实数据都已经在MYSQL_RES 变量中了，下面的api基本就是读取MYSQL_RES 中的数据。

5.获取结果行数和列数

cpp 复制代码

my_ulonglong mysql_num_rows(MYSQL_RES *res);
unsigned int mysql_num_fields(MYSQL_RES *res);

6.获取列名mysql_fetch_fields

cpp 复制代码

MYSQL_FIELD *mysql_fetch_fields(MYSQL_RES *res);

如：

cpp 复制代码

int fields = mysql_num_fields(res);
MYSQL_FIELD *field = mysql_fetch_fields(res);
int i = 0;
for(; i < fields; i++){
cout<<field[i].name<<" ";
}
cout<<endl;

7.获取结果内容mysql_fetch_row

cpp 复制代码

MYSQL_ROW mysql_fetch_row(MYSQL_RES *result);

获取一行数据，MYSQL_ROW其实就是char **，相当于一个char* 的数组，数组元素是每一列的内容；

如：

cpp 复制代码

i = 0;
MYSQL_ROW line;
for(; i < nums; i++){
line = mysql_fetch_row(res);
int j = 0;
for(; j < fields; j++){
cout<<line[j]<<" ";
}
cout<<endl;
}

8.释放结果空间mysql_free_result

cpp 复制代码

void mysql_free_result(MYSQL_RES *res);

释放查询结果空间，不能直接使用free释放空间；

9.关闭mysql链接mysql_close

cpp 复制代码

void mysql_close(MYSQL *sock);