linux下c++连接mysql数据库

在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)