在Linux下,我们可以通过MySQL提供的C API连接数据库。
使用C API连接mysql数据库除了要安装mysql-client和mysql-server,还需要安装mysql的开发包mysql-devel。
我的系统是fedora,安装命令如下:sudo yum install mysql-devel
ubuntu下安装命令:sudo apt-get install libmysqld-dev
然后加上<mysql/mysql.h>头文件就可以使用了。
想要具体了解C API函数的可以参考官方文档:官方mysql C API函数说明
我们在这里只介绍一些常用到的函数,以及将它们用c++封装起来,方便使用。
常用函数:
函数 | 说明 |
---|---|
MYSQL *mysql_init(MYSQL *mysql) | 获取或初始化MYSQL结构 |
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服务器。 |
int mysql_query(MYSQL *mysql, const char *stmt_str) | 执行指定为“以Null终结的字符串”的SQL查询。 |
MYSQL_RES *mysql_store_result(MYSQL *mysql) | 将查询的整个结果读取到客户端,分配一个 MYSQL_RES结构,并将结果放入此结构中 |
unsigned int mysql_field_count(MYSQL *mysql) | 返回上次执行语句的结果集的列数。 |
unsigned int mysql_num_fields(MYSQL_RES *result) | 返回结果集中的列数。 |
my_ulonglong mysql_num_rows(MYSQL_RES *result) | 返回结果集中的行数。 |
MYSQL_ROW mysql_fetch_row(MYSQL_RES *result) | 从结果集中获取下一行数据 |
void mysql_free_result(MYSQL_RES *result) | 释放结果集空间 |
相关数据结构:
- MYSQL结构体
此结构表示一个数据库连接的处理程序。它几乎用于所有MySQL功能。 - MYSQL_RES结构体
存储查询结果数据。 - MYSQL_ROW结构体
存储一行数据的结构。
相关函数的介绍:
1.mysql_init()
分配或初始化MYSQL适合的对象 mysql_real_connect()。如果 mysql是NULL指针,则该函数分配,初始化并返回一个新对象。否则,对象被初始化并返回对象的地址。如果 mysql_init()分配一个新的对象,当mysql_close()被调用来关闭该连接时它被释放 。如果没有足够的内存分配一个新对象,则返回NULL。
2. mysql_query()
执行指定为“以Null终结的字符串”的SQL查询。查询成功返回0,失败返回非0值。
3.mysql_field_count()
返回连接上最近查询的列数。
这个函数的正常使用是 mysql_store_result()返回 NULL(因此你没有结果集指针)。在这种情况下,您可以调用 mysql_field_count()确定是否 mysql_store_result()应该产生非空结果。这使得客户端程序能够在不知道查询是SELECT(或 类似SELECT))语句的情况下采取适当的操作。此处显示的示例说明了如何完成此操作。如果不理解的话,看完后面的代码示例就理解了。
基本步骤就是:
- 使用mysql_init()初始化连接
- 使用mysql_real_connect()建立一个到mysql数据库的连接
- 使用mysql_query()执行查询语句
- result = mysql_store_result(mysql)获取结果集
- mysql_num_fields(result)获取查询的列数,mysql_num_rows(result)获取结果集的行数
- 通过mysql_fetch_row(result)不断获取下一行,然后循环输出
- 释放结果集所占内存mysql_free_result(result)
- mysql_close(conn)关闭连接
为了使用方便,我用c++进行了简单的封装:MyDB.h和MyDB.CPP
MyDB.h
/*************************************************************************
> File Name: mydb.h
> Author:fengxin
> Mail:903087053@qq.com
> Created Time: 2017年07月21日 星期五 15时17分17秒
************************************************************************/
#ifndef _MYDB_H
#define _MYDB_H
#include<iostream>
#include<string>
#include<mysql/mysql.h>
using namespace std;
class MyDB
{
public:
MyDB();
~MyDB();
bool initDB(string host,string user,string pwd,string db_name); //连接mysql
bool exeSQL(string sql); //执行sql语句
private:
MYSQL *mysql; //连接mysql句柄指针
MYSQL_RES *result; //指向查询结果的指针
MYSQL_ROW row; //按行返回的查询信息
};
#endif
MyDB.cpp
/*************************************************************************
> File Name: MyDB.cpp
> Author:fengxin
> Mail:903087053@qq.com
> Created Time: 2017年07月21日 星期五 16时02分51秒
************************************************************************/
#include<iostream>
#include<string>
#include "MyDB.h"
using namespace std;
MyDB::MyDB()
{
mysql=mysql_init(NULL); //初始化数据库连接变量
if(mysql==NULL)
{
cout<<"Error:"<<mysql_error(mysql);
exit(1);
}
}
MyDB::~MyDB()
{
if(mysql!=NULL) //关闭数据连接
{
mysql_close(mysql);
}
}
bool MyDB::initDB(string host,string user,string passwd,string db_name)
{
// 函数mysql_real_connect建立一个数据库连接
// 成功返回MYSQL*连接句柄,失败返回NULL
mysql = mysql_real_connect(mysql, host.c_str(), user.c_str(), passwd.c_str(), db_name.c_str(), 0, NULL, 0);
if(mysql == NULL)
{
cout << "Error: " << mysql_error(mysql);
exit(1);
}
return true;
}
bool MyDB::exeSQL(string sql)
{
//mysql_query()执行成功返回0,执行失败返回非0值。
if (mysql_query(mysql,sql.c_str()))
{
cout<<"Query Error: "<<mysql_error(mysql);
return false;
}
else // 查询成功
{
result = mysql_store_result(mysql); //获取结果集
if (result) // 返回了结果集
{
int num_fields = mysql_num_fields(result); //获取结果集中总共的字段数,即列数
int num_rows=mysql_num_rows(result); //获取结果集中总共的行数
for(int i=0;i<num_rows;i++) //输出每一行
{
//获取下一行数据
row=mysql_fetch_row(result);
if(row<0) break;
for(int j=0;j<num_fields;j++) //输出每一字段
{
cout<<row[j]<<"\t\t";
}
cout<<endl;
}
}
else // result==NULL
{
if(mysql_field_count(mysql) == 0) //代表执行的是update,insert,delete类的非查询语句
{
// (it was not a SELECT)
int num_rows = mysql_affected_rows(mysql); //返回update,insert,delete影响的行数
}
else // error
{
cout<<"Get result error: "<<mysql_error(mysql);
return false;
}
}
}
return true;
}
编译:
编译时,记得在末尾加上
`mysql_config --cflags --libs`
才能编译通过。
例如:
g++ MyDB.cpp test.cpp -o test `mysql_config --cflags --libs`
使用示例:
测试的例子是,创建一个test数据库,向数据库里的记录用户帐号密码的accounts表中添加和查询数据。
首先,我们在终端下登录数据库,创建一个test数据库,并创建一个名为accounts的表。
mysql -u root -p
Enter password:
Welcome to the MySQL monitor.
mysql>create database test;
Query OK, 1 row affected (0.00 sec)
mysql>use test;
Database changed
mysql>create table accounts(name char(20) not null primary key,passwd char(20) not null);
Query OK, 0 rows affected (0.52 sec)
mysql>exit;
相关的表创建完成,接下来通过test.cpp来向数据库中添加两条用户帐号的信息并将它读取出来。
代码如下:
/*************************************************************************
> File Name: test.cpp
> Author:fengxin
> Mail:903087053@qq.com
> Created Time: 2017年07月21日 星期五 16时43分55秒
************************************************************************/
#include<iostream>
#include"MyDB.h"
using namespace std;
int main()
{
MyDB db;
//连接数据库
db.initDB("localhost","root","fengxin","test");
//将用户信息添加到数据库
db.exeSQL("INSERT accounts values('fengxin','123');");
db.exeSQL("INSERT accounts values('axin','456');");
//将所有用户信息读出,并输出。
db.exeSQL("SELECT * from accounts;");
return 0;
}
我写了一个简单的Makefile,编译起来更加方便。
test:test.cpp MyDB.cpp
g++ test.cpp MyDB.cpp -o test `mysql_config --cflags --libs`
然后执行make,并运行test。
运行结果如下:
./test
axin 456
fengxin 123
通过终端连接数据库查看accounts表的内容,我们看到的结果也是一样的。
mysql> select * from accounts;
+---------+--------+
| name | passwd |
+---------+--------+
| axin | 456 |
| fengxin | 123 |
+---------+--------+
2 rows in set (0.00 sec)