目录
一.准备工作
二.Connector/C 使用
2.mysql接口介绍
一.准备工作
要使用C语言连接mysql,需要使用mysql官网提供的库,大家可以去官网下载
我们使用C接口库来进行连接
要正确使用,我们需要做一些准备工作:
- 保证mysql服务有效
- 在官网上下载合适自己平台的mysql connect库,以备后用
- 下载
命令:sudo yum install mysql-devel
二.Connector/C 使用
如果是直接到MySQL官网下载的库,需要自己打包成库使用,将生成的库路径写入OS。
1.引入MySQL库
mysql.c-api5.7function-reference
测试是否引入成功:
通过 mysql_get_client_info() 函数,来验证我们的引入是否成功;
#include <iostream>
#include </usr/include/mysql/mysql.h>
// 头文件路径+库文件路径+库名
//-I/usr/include/mysql -L/usr/lib64/mysql/ -lmysqlclient
using namespace std;
int main()
{
cout << "mysql client Version:" << mysql_get_client_info() << endl;
return 0;
}
makefile:
test:test.cc
g++ -o $@ $^ -std=c++11 -lmysqlclient
.PHONY:clear
clear:
rm -rf test
测试结果:
如果在编译的时候出现找不到文件,就将完整的库文件路径,头文件路径指定清楚:
g++ -o test test.cc -std=c++11 -I/usr/include/mysql -L/usr/lib64/mysql/ -lmysqlclient
至此引入库的工作已经做完,接下来就是熟悉接口.
2.mysql接口介绍
初始化mysql_init():
要使用库,必须先进行初始化!
MYSQL *mysql_init(MYSQL *mysql);
分配或初始化一个适用于mysql_real_connect()的MYSQL对象。如果mysql参数是一个空指针,函数将分配、初始化并返回一个新的对象。否则,对象将被初始化,并返回对象的地址。如果mysql_init()分配了一个新的对象,当调用mysql_close()关闭连接时,它将被释放。
连接数据库mysql_real_connect:
初始化完毕之后,必须先链接数据库,在进行后续操作。(mysql网络部分是基于TCP/IP的)
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 client_flag)
mysql_real_connect()尝试建立与运行在主机上的MySQL服务器的连接。客户端程序必须在执行任何其他需要有效的MYSQL连接处理程序结构的有效API函数之前成功连接到服务器。
第一个参数 MYSQL是 C api中一个非常重要的变量(mysql_init的返回值),里面内存非常丰富,有port,dbname,charset等连接基本参数。它也包含了一个叫 st_mysql_methods的结构体变量,该变量里面保存着很多函数指针,这些函数指针将会在数据库连接成功以后的各种数据操作中被调用。mysql_real_connect函数中各参数,基本都是顾名思意。
mysql_real_connect() 的返回值是一个指向 MYSQL 连接句柄的结构体指针。如果连接成功,返回值为非空指针;如果连接失败,返回值为 NULL。
测试代码:
#include <iostream>
#include </usr/include/mysql/mysql.h>
// 头文件路径+库文件路径+库名
//-I/usr/include/mysql -L/usr/lib64/mysql/ -lmysqlclient
using namespace std;
const char *host = "118.178.232.144";
int main()
{
cout << "mysql client Version:" << mysql_get_client_info() << endl;
MYSQL *mpf = mysql_init(nullptr);
MYSQL *mysql_connect = mysql_real_connect(mpf, host, "wangqing", "200209", "scott", 3306, nullptr, 0);
if (mysql_connect)
cout << "mysql connect success" << endl;
else
cout << "mysql connect fail" << endl;
return 0;
}
下发mysql命令mysql_query:
int mysql_query(MYSQL *mysql, const char *q);
第一个参数上面已经介绍过,第二个参数为要执行的sql语句。
测试代码:
// 下达SQL指令
int n = mysql_query(mysql_connect, "insert into stu value(8,'newsuer1')");
int n = mysql_query(mysql_connect, "insert into stu value(9,'newsuer2')");
int n = mysql_query(mysql_connect, "insert into stu value(10,'newsuer3')");
程序执行后查看表的内容:
获取执行结果mysql_store_result:
sql执行完以后,如果是查询语句,我们当然还要读取数据,如果update,insert等语句,那么就看下操作成功与否即可。我们来看看如何获取查询结果: 如果mysql_query返回成功,那么我们就通过mysql_store_result这个函数来读取结果。原型如下:
MYSQL_RES *mysql_store_result(MYSQL *mysql);
MYSQL_RES结构:
typedef struct st_mysql_res
{
my_ulonglong row_count; // 行数
MYSQL_FIELD *fields; // 是一个数组,包含每一列信息,列名字,等属性
MYSQL_DATA *data;
MYSQL_ROWS *data_cursor;
unsigned long *lengths; /* column lengths of current row */
MYSQL *handle; /* for unbuffered reads */
const struct st_mysql_methods *methods;
MYSQL_ROW row; /* If unbuffered read 表的内容,数组指针,*/
MYSQL_ROW current_row; /* buffer to current row */
MEM_ROOT field_alloc;
unsigned int field_count, current_field;
my_bool eof; /* Used by mysql_fetch_row */
/* mysql_stmt_close() had to cancel this result */
my_bool unbuffered_fetch_cancelled;
void *extension;
} MYSQL_RES;
该函数会调用MYSQL变量中的st_mysql_methods中的 read_rows 函数指针来获取查询的结果。同时该函数会返回MYSQL_RES 这样一个变量,该变量主要用于保存查询的结果。同时该函数malloc了一片内存空间来存储查询过来的数据,所以我们一定要记的 free(result),不然是肯定会造成内存泄漏的。 执行完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);
测定代码:
#include <iostream>
#include <string>
#include <cstring>
#include </usr/include/mysql/mysql.h>
// 头文件路径+库文件路径+库名
//-I/usr/include/mysql -L/usr/lib64/mysql/ -lmysqlclient
using namespace std;
const char *host = "118.178.232.144";
const char *user = "wangqing";
const char *pass = "200209";
const char *databases = "scott";
const int port = 3306;
int main()
{
// 1.测试MySQL库引入
cout << "mysql client Version:" << mysql_get_client_info() << endl;
// 2.创建MySQL对象
MYSQL *mpf = mysql_init(nullptr);
// 3.连接MySQL
mysql_real_connect(mpf, host, user, pass, databases, port, nullptr, 0);
if (mpf)
cout << "mysql connect success" << endl;
else
cout << "mysql connect fail" << endl;
// 4.下达SQL指令
int n1 = mysql_query(mpf, "select * from stu");
// int n2 = mysql_query(mpf, "insert into stu value(9,'newsuer2')");
// int n3 = mysql_query(mpf, "insert into stu value(10,'newsuer3')");
// 5.获取执行结果
MYSQL_RES *ret = mysql_store_result(mpf);
if (ret)
cout << "read result success" << endl;
else
cout << "read result fail" << endl;
// 5.1获取行数
my_ulonglong count_row = mysql_num_rows(ret);
// 5.2获取列数
unsigned int count_col = mysql_num_fields(ret);
cout << count_row << ":" << count_col << endl;
// 5.3获取列名
// MYSQL_FIELD是一个结构体,里面包含了该列的所有属性
MYSQL_FIELD *col_mess = mysql_fetch_fields(ret);
for (int i = 0; i < count_col; i++)
{
cout << col_mess[i].name << " ";
}
cout << endl;
mysql_free_result(ret); // 释放获取执行结果
mysql_close(mpf); // 关闭mysql连接
return 0;
}
测试结果
获取结果内容mysql_fetch_row:
mysql_fetch_row获取每一行的结果并且在下一次调用时自动指向下一行:
// 5.4获取数据
for (int i = 0; i < count_row; i++)
{
// MYSQL_ROW是一个字符串数组,存储当前行,每一列的数据
MYSQL_ROW line = mysql_fetch_row(ret);
for (int j = 0; j < count_col; j++)
cout << line[j] << "\t";
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);