MySQL——C/C++连接数据库

目录

一.准备工作

二.Connector/C 使用

1.引入MySQL库

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