【MySQL 15】使用 C/C++ 连接数据库

小兔子酱#2024-09-04 0:37

文章目录

  • [🌈 一、引入 MySQL 库](#🌈 一、引入 MySQL 库)
    • [⭐ 1. 下载库文件](#⭐ 1. 下载库文件)
    • [⭐ 2. 上传库文件](#⭐ 2. 上传库文件)
    • [⭐ 3. 引用库文件](#⭐ 3. 引用库文件)
    • [⭐ 4. 验证是否引入成功](#⭐ 4. 验证是否引入成功)
  • [🌈二、MySQL 接口介绍](#🌈二、MySQL 接口介绍)
    • [⭐ 1. 初始化](#⭐ 1. 初始化)
    • [⭐2. 连接数据库](#⭐2. 连接数据库)
    • [⭐ 3. 关闭数据库连接](#⭐ 3. 关闭数据库连接)
    • [⭐ 4. 设置编码格式](#⭐ 4. 设置编码格式)
    • [⭐ 5. 发送 sql 指令](#⭐ 5. 发送 sql 指令)
      • [🌙 5.1 向数据库表中插入数据](#🌙 5.1 向数据库表中插入数据)
      • [🌙 5.2 修改数据库表中的数据](#🌙 5.2 修改数据库表中的数据)
      • [🌙 5.3 删除数据库表中的数据](#🌙 5.3 删除数据库表中的数据)
    • [⭐ 6. 获取查询结果](#⭐ 6. 获取查询结果)
      • [🌙 6.1 获取查询结果的行数](#🌙 6.1 获取查询结果的行数)
      • [🌙 6.2 获取查询结果的列数](#🌙 6.2 获取查询结果的列数)
      • [🌙 6.3 获取查询结果的列属性](#🌙 6.3 获取查询结果的列属性)
      • [🌙 6.4 获取查询结果的内容](#🌙 6.4 获取查询结果的内容)
      • [🌙 6.5 获取查询结果示例](#🌙 6.5 获取查询结果示例)

🌈 一、引入 MySQL 库

⭐ 1. 下载库文件

  • 再选择人家推荐得那个版本即可。
  • 选择适合自己平台的，然后下载即可。

⭐ 2. 上传库文件

  • 将刚刚下下来的解压包上传到 Linux 服务器上，可以专门建一个 third_part_lib 目录用于存储这些第三方库，
  • 将下好的文件直接使用 rz -E 上传到云服务器上。
  • 再将压缩包使用 tar -xzf 命令进行解压。
  • 如果觉得解压之后的文件名太长了也可以换个名字，我这里是改成了 mysql-connector。

⭐ 3. 引用库文件

  • 在刚刚解压出来的 mysql-connector 目录中，有两个目录是最重要的。
  • include 目录下存放着各种头文件。
  • lib 目录下存放着所需的动静态库。
  • 为了项目能够方便的使用这两个目录中的文件，可在项目目录下使用软链接的方式链接到 include 和 lib 这两个目录。

⭐ 4. 验证是否引入成功

  • 通过调用 mysql_get_client_info 来判断库是否引入成功，该函数的作用就是获取客户端的版本信息。
cpp 复制代码 
// 文件名 test.cpp
#include <mysql.h>
#include <iostream>

using namespace std;

int main()
{
    cout << "mysql client version: " << mysql_get_client_info() << endl;

    return 0;
}
  • 对该文件进行编译，编译完成后再运行形成的 .exe 可执行程序，如果能成功显示客户端的版本信息则说明库引入成功。
bash 复制代码 
g++ -o test.exe test.cpp -I./include -L./lib -lmysqlclient

🌈二、MySQL 接口介绍

⭐ 1. 初始化

  • 要使用库，得先使用 mysql_init() 进行初始化构建一个 MySQL 对象。
cpp 复制代码 
MYSQL* 对象名 = mysql_init(MYSQL *mysql);
  • 该函数用来分配或初始化一个 MySQL 对象，用于连接 MySQL 服务器。
  • 如果传入得参数是个空指针，则 mysql_init 函数会自动分配一个 MySQL 对象并返回。
  • 如果传入得参数是一个地址，则 mysql_init 会在该地址处完成初始化。

⭐2. 连接数据库

cpp 复制代码 
MYSQL *mysql_real_connect(
    MYSQL *mysql,				// mysql_init 函数创建的 MySQL 对象
    const char *host,			// 需要连接的 MySQL 主机的 ip 地址，"127.0.0.1" 表示本机地址
    const char *user,			// 连接 MySQL 服务器时，所使用的用户的用户名
    const char *passwd,			// 连接 MySQL 服务器时，对应用户的用户密码
    const char *db,				// 连接 MySQL 服务器后，所要使用的数据库
    unsigned int port,			// 连接的 MySQL 服务器所对应的端口号
    const char *unix_socket,	// 连接时应该使用的套接字或命名管道，通常设置为 空指针
    unsigned long clientflag);	// 标志位组合，表示允许特定的功能，通常被置为 0
  • 如果数据库连接成功，则返回一个MySQL 对象，该对象与第一个参数的值相同。
  • 如果连接失败，则返回空指针 NULL / nullptr。

举个栗子

  • 如果运行下面的代码之后能够成功显示 "数据库连接成功" 这几个字就说明连接成功了。
cpp 复制代码 
#include <mysql.h>
#include <iostream>

using std::cerr;
using std::cout;
using std::endl;
using std::string;

const string host = "127.0.0.1";  // 主机 ip
const string user = "connector";  // 用户名
const string passwd = "123456";   // 用户密码
const string db = "conn";         // 数据库
const int port = 3306;            // 端口号

int main()
{
    // 初始化一个 MYSQL 对象
    MYSQL *mfp = mysql_init(nullptr);
    if (nullptr == mfp)
    {
        cerr << "init MySQL error" << endl;
        return 1;
    }

    // 连接数据库
    if (nullptr == mysql_real_connect(mfp, host.c_str(), user.c_str(),
                                      passwd.c_str(), db.c_str(), port, nullptr, 0))
    {
        cerr << "数据库连接失败" << endl;
        return 2;
    }

    cout << "数据库连接成功" << endl;

    // 断连数据库
    mysql_close(mfp);

    return 0;
}

⭐ 3. 关闭数据库连接

cpp 复制代码 
void mysql_close(MYSQL *sock);
  • 与数据库交互完毕后，需要关闭数据库连接。
  • sock 是使用 mysql_init 创建得 MYSQL 对象，如果传入得 MYSQL 对象是 由mysql_init 创建的，那么调用 mysql_close 就会释放该对象。

⭐ 4. 设置编码格式

  • 连接完数据库后，还要统一客户端和服务器的编码格式，避免在数据交互过程中出现乱码的情况。
cpp 复制代码 
int mysql_set_character_set(MYSQL *mysql, const char *csname);
  • mysql：该参数表示 MYSQL 对象
  • csname：该参数表示要设置的编码格式 (如 utf8 这种)。
  • 返回值为 0 则表示设置成功，其他则为设置失败。

⭐ 5. 发送 sql 指令

  • 在与数据库建立了连接之后，可以使用下面的指令向数据库对象发送 sql 指令。
cpp 复制代码 
int mysql_query(MYSQL *mysql, const char *q);
  • mysql：该参数表示 MYSQL 对象
  • q：该参数表示要执行的 sql 语句 (这里的 sql 可不带分号)。
  • 返回值为 0 则表示 sql 执行成功，反之则表示执行失败。

准备测试表

  • 在 conn 数据库中创建一张名为 user 的表，表中包含用户 id、姓名 name、年龄 age、电话 telphone 这四个字段。
    • 之后的操作都是基于这张表进行的。

🌙 5.1 向数据库表中插入数据

  • 在调用 mysql_query 函数时，向 MySQL 服务器发送一条 insert 语句。
cpp 复制代码 
#include <mysql.h>
#include <iostream>

using std::cerr;
using std::cout;
using std::endl;
using std::string;

const string host = "127.0.0.1";  // 主机 ip
const string user = "connector";  // 用户名
const string passwd = "123456";   // 用户密码
const string db = "conn";         // 数据库
const int port = 3306;            // 端口号

int main()
{
    // 初始化一个 MYSQL 对象
    MYSQL *mfp = mysql_init(nullptr);
    if (nullptr == mfp)
    {
        cerr << "init MySQL error" << endl;
        return 1;
    }

    // 连接数据库
    if (nullptr == mysql_real_connect(mfp, host.c_str(), user.c_str(),
                                      passwd.c_str(), db.c_str(), port, nullptr, 0))
    {
        cerr << "数据库连接失败" << endl;
        return 2;
    }

    cout << "数据库连接成功" << endl;

    // 设置编码集
    if (0 != mysql_set_character_set(mfp, "utf8"))
    {
        cerr << "编码集设置失败" << endl;
        return 3;
    }

    /* ---------- 看这里 ---------- */
    // 发送 sql 请求
    const string sql = "insert into user values (1, '张三', 18, '12355667788')";
    if (0 != mysql_query(mfp, sql.c_str()))
    {
        cerr << "插入数据失败" << endl;
        return 4;
    }

    cout << "插入数据成功" << endl;

    // 断连数据库
    mysql_close(mfp);

    return 0;
}
  • 运行这段代码之后，能看到 MySQL 中的 user 表确实多出了这么一行数据。

🌙 5.2 修改数据库表中的数据

  • 在调用 mysql_query 函数时，向 MySQL 服务器发送一条 update 语句。
    • 例：将张三的名字改成李四
cpp 复制代码 
#include <mysql.h>
#include <iostream>

using std::cerr;
using std::cout;
using std::endl;
using std::string;

const string host = "127.0.0.1";  // 主机 ip
const string user = "connector";  // 用户名
const string passwd = "123456";   // 用户密码
const string db = "conn";         // 数据库
const int port = 3306;            // 端口号

int main()
{
    // 初始化一个 MYSQL 对象
    MYSQL *mfp = mysql_init(nullptr);
    if (nullptr == mfp)
    {
        cerr << "init MySQL error" << endl;
        return 1;
    }

    // 连接数据库
    if (nullptr == mysql_real_connect(mfp, host.c_str(), user.c_str(),
                                      passwd.c_str(), db.c_str(), port, nullptr, 0))
    {
        cerr << "数据库连接失败" << endl;
        return 2;
    }

    cout << "数据库连接成功" << endl;

    // 设置编码集
    if (0 != mysql_set_character_set(mfp, "utf8"))
    {
        cerr << "编码集设置失败" << endl;
        return 3;
    }
    
    /* ---------- 看这里 ---------- */
    // 发送 sql 请求
    const string sql = "update user set name = '李四' where id = 1";
    if (0 != mysql_query(mfp, sql.c_str()))
    {
        cerr << "修改数据失败" << endl;
        return 4;
    }

    cout << "修改数据成功" << endl;

    // 断连数据库
    mysql_close(mfp);

    return 0;
}
  • 运行这段代码之后，再查看 user 表，发现张三的名字确实变成李四了。

🌙 5.3 删除数据库表中的数据

  • 在调用 mysql_query 函数时，向 MySQL 服务器发送一条 delete 语句。
cpp 复制代码 
#include <mysql.h>
#include <iostream>

using std::cerr;
using std::cout;
using std::endl;
using std::string;

const string host = "127.0.0.1";  // 主机 ip
const string user = "connector";  // 用户名
const string passwd = "123456";   // 用户密码
const string db = "conn";         // 数据库
const int port = 3306;            // 端口号

int main()
{
    // 初始化一个 MYSQL 对象
    MYSQL *mfp = mysql_init(nullptr);
    if (nullptr == mfp)
    {
        cerr << "init MySQL error" << endl;
        return 1;
    }

    // 连接数据库
    if (nullptr == mysql_real_connect(mfp, host.c_str(), user.c_str(),
                                      passwd.c_str(), db.c_str(), port, nullptr, 0))
    {
        cerr << "数据库连接失败" << endl;
        return 2;
    }

    cout << "数据库连接成功" << endl;

    // 设置编码集
    if (0 != mysql_set_character_set(mfp, "utf8"))
    {
        cerr << "编码集设置失败" << endl;
        return 3;
    }

    /* ---------- 看这里 ---------- */
    // 发送 sql 请求
    const string sql = "delete from user where id = 1";
    if (0 != mysql_query(mfp, sql.c_str()))
    {
        cerr << "删除数据失败" << endl;
        return 4;
    }

    cout << "删除数据成功" << endl;

    // 断连数据库
    mysql_close(mfp);

    return 0;
}

⭐ 6. 获取查询结果

  • 对数据库中的数据进行 增删改 操作时，只要调用 mysql_query 成功即可。
  • 而对数据库中的数据进行 查询 操作时，除了调用 mysql_query 函数，还需要能够获取 MySQL 返回的这些数据。
  • 当 mysql_query 函数成功执行 select 语句时，可以使用下面的函数获取查询结果。
    • 之后的四种查询结果都是根据该函数的返回值确定的。
cpp 复制代码 
MYSQL_RES* mysql_store_result(MYSQL *mysql);
  • 该函数会调用指定 MYSQL 对象中对应的函数指针来获取查询结果，并将获取到的查询结果保存到 MYSQL_RES 变量中进行返回。

MYSQL_RES 的内容

  • 该结构体会以行里的形式将查询的数据保存起来。
cpp 复制代码 
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;

🌙 6.1 获取查询结果的行数

cpp 复制代码 
my_ulonglong mysql_num_rows(MYSQL_RES *res);
  • 该函数会从指定的 MYSQL_RES 对象中，获取查询结果的行数。

🌙 6.2 获取查询结果的列数

cpp 复制代码 
unsigned int mysql_num_fields(MYSQL_RES *res);
  • 该函数会从指定的 MYSQL_RES 对象中，获取查询结果的列数

🌙 6.3 获取查询结果的列属性

cpp 复制代码 
MYSQL_FIELD* mysql_fetch_fields(MYSQL_RES *res);
  • 该函数会从指定 MYSQL_RES 对象中，获取查询结果的列名。

MYSQL_FIELD 的内容

cpp 复制代码 
typedef struct st_mysql_field
{
    char *name;               /* Name of column */
    char *org_name;           /* Original column name, if an alias */
    char *table;              /* Table of column if column was a field */
    char *org_table;          /* Org table name, if table was an alias */
    char *db;                 /* Database for table */
    char *catalog;            /* Catalog for table */
    char *def;                /* Default value (set by mysql_list_fields) */
    unsigned long length;     /* Width of column (create length) */
    unsigned long max_length; /* Max width for selected set */
    unsigned int name_length;
    unsigned int org_name_length;
    unsigned int table_length;
    unsigned int org_table_length;
    unsigned int db_length;
    unsigned int catalog_length;
    unsigned int def_length;
    unsigned int flags;         /* Div flags */
    unsigned int decimals;      /* Number of decimals in field */
    unsigned int charsetnr;     /* Character set */
    enum enum_field_types type; /* Type of field. See mysql_com.h for types */
    void *extension;
} MYSQL_FIELD;

🌙 6.4 获取查询结果的内容

cpp 复制代码 
MYSQL_ROW mysql_fetch_row(MYSQL_RES *result);
  • 该函数会从指定的 MYSQL_RES 对象中，获取查询结果中的单行数据。
  • 该函数的返回值实际上就是个二维数组，数组中保存着这一行中每一列的数据。

🌙 6.5 获取查询结果示例

  • 先往表中插入三条记录，方便之后的查询。
cpp 复制代码 
#include <mysql.h>
#include <iostream>

using std::cerr;
using std::cout;
using std::endl;
using std::string;

const string host = "127.0.0.1"; // 主机 ip
const string user = "connector"; // 用户名
const string passwd = "123456";  // 用户密码
const string db = "conn";        // 数据库
const int port = 3306;           // 端口号

int main()
{
    // 初始化一个 MYSQL 对象
    MYSQL *mfp = mysql_init(nullptr);
    if (nullptr == mfp)
    {
        cerr << "init MySQL error" << endl;
        return 1;
    }

    // 连接数据库
    if (nullptr == mysql_real_connect(mfp, host.c_str(), user.c_str(),
                                      passwd.c_str(), db.c_str(), port, nullptr, 0))
    {
        cerr << "数据库连接失败" << endl;
        return 2;
    }

    cout << "数据库连接成功" << endl;

    // 设置编码集
    if (0 != mysql_set_character_set(mfp, "utf8"))
    {
        cerr << "编码集设置失败" << endl;
        return 3;
    }

    // 发送 sql 请求
    const string sql = "select * from user";
    if (0 != mysql_query(mfp, sql.c_str()))
    {
        cerr << "查询数据失败" << endl;
        return 4;
    }
    cout << "查询数据成功" << endl;

    // 获取查询结果
    MYSQL_RES *res = mysql_store_result(mfp);
    if (nullptr == res)
    {
        cerr << "调用 mysql_store_result 函数失败" << endl;
        return 5;
    }

    my_ulonglong rows = mysql_num_rows(res);      // 获取查询结果的行数
    my_ulonglong cols = mysql_num_fields(res);    // 获取查询结果的列数
    
    MYSQL_FIELD *fields = mysql_fetch_field(res); // 获取每一列的列明
    for (size_t i = 0; i < cols; i++)             // 打印所有的列名
        cout << fields[i].name << "\t";
    cout << endl;

    for (size_t i = 0; i < rows; i++)
    {
        MYSQL_ROW row = mysql_fetch_row(res);     // 获取第 i 行的数据

        for (size_t j = 0; j < cols; j++)         // 打印获取到的这行的第 j 列的数据
            cout << row[j] << "\t";
        cout << endl;
    }

    free(res);                                    //释放内存空间

    // 断连数据库
    mysql_close(mfp);

    return 0;
}
  • 运行上述代码之后的结果如下：
相关推荐
Looooking4 分钟前
MySQL 中常用函数使用
数据库·mysql
q5673152311 分钟前
如何在Django中创建新的模型实例
数据库·python·线性代数·django·sqlite
island131421 分钟前
从 InnoDB 到 Memory：MySQL 存储引擎的多样性
数据库·学习·mysql
ZZDICT1 小时前
MySQL 子查询
数据库·mysql
isNotNullX1 小时前
如何用SQL Server和Oracle进行数据同步？
大数据·数据库·sql·oracle
大母猴啃编程1 小时前
数据结构---非线性--树
c语言·数据结构·学习·算法·青少年编程
码农探知1 小时前
鹏哥C语言自定义笔记重点(67-)
c语言·数据结构
柳鲲鹏1 小时前
编译成功！QT/6.7.2/Creator编译Windows64 MySQL驱动(MinGW版)
开发语言·qt·mysql
让学习成为一种生活方式1 小时前
解析药用植物重楼甾体皂苷生物合成中的连续糖基化及其抗真菌作用-文献精读49
linux·数据库·算法·天然产物化学
追逐远方的梦1 小时前
二级C语言2023-3易错题
c语言·开发语言
热门推荐
01RAG 实践- Ollama+RagFlow 部署本地知识库02组基轨迹建模 GBTM的介绍与实现（Stata 或 R）032024年高教社杯数学建模国赛C题超详细解题思路分析04苍穹外卖面试总结05Coze扣子平台完整体验和实践（附国内和国际版对比）06【2024数模国赛赛题思路公开】国赛B题思路丨附可运行代码丨无偿自提07yolov8实战第五天——yolov8+ffmpg实时视频流检测并进行实时推流——（推流，保姆教学）08【立创EDA-PCB设计基础】6.布线铺铜实战及细节详解09【2024高教社杯全国大学生数学建模竞赛】B题 生产过程中的决策问题——解题思路 代码 论文10CANoe Trace窗口过滤栏消失的几种解决方法（附上最终解决方案）