使用 C/C++访问 MySQL

目录

准备工作

尝试链接 MySQL Client

MySQL 接口介绍

---

准备工作

1. 保证 MySQL 服务有效。
2. 下载MySQL开发包（可以在MySQL官网下载安装也可以在软件源安装）

MySQL 开发包通常会包含一些特定的头文件和库文件。您可以检查以下常见的路径：

 

• /usr/include/mysql ：查找 MySQL 相关的头文件。

• /usr/lib 或 /usr/lib64 ：查找与 MySQL 相关的库文件，例如 libmysqlclient.so 。

尝试链接 MySQL Client

通过 mysql_get_client_info() 函数，来验证我们的引入是否成功。

#include <stdio.h>
#include <mysql.h> 

int main()
{
    printf("mysql client Version: %s\n", mysql_get_client_info());
    return 0;
}

编译命令：

user1@hecs-133240:~$ gcc - o test test.c - I./include - L./lib - lmysqlclient

运行时出现错误：

user1@hecs-133240:~$./test
./test: error while loading shared libraries: libmysqlclient.so.18: cannot open shared
object file: No such file or directory

解决方法：设置动态库查找路径

user1@hecs-133240:~$ export LD_LIBRARY_PATH =./lib 

这样就成功地将当前目录下的 lib 文件夹添加到了 LD_LIBRARY_PATH 环境变量中，使得系统在运行程序查找动态链接库时，也会在这个指定的目录中进行搜索。

再次运行：

user1@hecs-133240:~$./test
mysql client Version: 6.1.6

至此引入库的工作已经做完，接下来就是熟悉接口。

MySQL 接口介绍

1.初始化 mysql_init()：
要使用库，必须先进行初始化！

MYSQL *mysql_init(MYSQL *mysql);

例如：MYSQL *mfp = mysql_init(NULL); 

返回值是一个MySQL文件句柄，后续的操作都要用它

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

//返回nullptr则代表连接失败
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。

mysql_set_character_set(myfd, "utf8");

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

3. 下发 MySQL 命令 mysql_query：

// 返回0表示成功，非0失败
int mysql_query(MYSQL *mysql, const char *q);

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

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

MYSQL_RES *mysql_store_result(MYSQL *mysql);

该函数会调用 MYSQL 变量中的 st_mysql_methods 中的 read_rows 函数指针来获取查询的结果。同时该函数会返回 MYSQL_RES 这样一个变量，该变量主要用于保存查询的结果。同时该函数 malloc 了一片内存空间来存储查询过来的数据，

所以我们一定要记得 free(result)，不然是肯定会造成内存泄漏的；但较高版本的MySQL直接使用free释放内存会直接出现段错误，我们需要使用专门提供的库函数mysql_free_result(res);
执行完 mysql_store_result 以后，其实数据都已经在 MYSQL_RES 变量中了，下面的 API 基本就是读取 MYSQL_RES 中的数据。

• 获取结果行数 mysql_num_rows：

my_ulonglong mysql_num_rows(MYSQL_RES *res);

• 获取结果列数 mysql_num_fields：

unsigned int mysql_num_fields(MYSQL_RES *res);

• 获取列名 mysql_fetch_fields：

MYSQL_FIELD *mysql_fetch_fields(MYSQL_RES *res);

例如：

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;

• 获取结果内容 mysql_fetch_row：

MYSQL_ROW mysql_fetch_row(MYSQL_RES *result);

它会返回一个 MYSQL_ROW 变量，MYSQL_ROW 其实就是 char **。就当成一个二维数组来用吧。
例如：

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

• 关闭 MySQL 链接 mysql_close：

void mysql_close(MYSQL *sock);

---

另外，MySQL C API 还支持事务等常用操作：

my_bool STDCALL mysql_autocommit(MYSQL * mysql, my_bool auto_mode); 
my_bool STDCALL mysql_commit(MYSQL * mysql); 
my_bool STDCALL mysql_rollback(MYSQL * mysql);

在 MySQL 的 C API 中，事务操作是确保数据一致性和完整性的重要手段。

• 开启事务：

使用 mysql_autocommit() 函数来关闭自动提交模式，从而开启一个事务。

if (mysql_autocommit(conn, 0)!= 0) {
    // 处理错误
}

• 执行事务中的操作：

在事务开启后，可以执行一系列的数据库操作，例如插入、更新、删除数据等。

• 提交事务：

使用 mysql_commit() 函数来提交事务，使事务中的操作生效。

if (mysql_commit(conn)!= 0) {
    // 处理错误
}

• 回滚事务：

如果在事务执行过程中出现错误或需要取消事务的操作，可以使用 mysql_rollback() 函数进行回滚。

if (mysql_rollback(conn)!= 0) {
    // 处理错误
}

例如，如果在一个银行转账的场景中，从账户 A 向账户 B 转账，需要先从账户 A 扣除相应金额，如果这个操作成功，再向账户 B 增加相应金额。如果在向账户 B 增加金额时出现错误，就需要回滚之前从账户 A 扣除金额的操作，以保证数据的一致性。

在实际使用中，要注意及时处理函数返回的错误码，以确保事务操作的正确执行。

总结：