linux下c++连接mysql数据库

时间:2021-12-09 11:31:57

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