准备工作
- 保证 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 扣除金额的操作,以保证数据的一致性。
在实际使用中,要注意及时处理函数返回的错误码,以确保事务操作的正确执行。
总结:
以上就是使用c/c++访问mysql的教程详解的详细内容,更多关于c/c++访问mysql的资料请关注代码网其它相关文章!
发表评论