目录
准备工作
尝试链接 MySQL Client
MySQL 接口介绍
准备工作
- 保证 MySQL 服务有效。
- 下载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 扣除金额的操作,以保证数据的一致性。
在实际使用中,要注意及时处理函数返回的错误码,以确保事务操作的正确执行。
总结: