【MySQL系列】使用C语言连接MySQL

枫叶先生2023-09-21 6:00

「前言」文章内容大致是使用C语言连接MySQL。

「归属专栏」MySQL

「主页链接」个人主页

「笔者」枫叶先生(fy)

目录

一、Connector/C使用

按照前面MySQL的安装流程，安装完MySQL，MySQL相应的连接相关的库也被下载下来了

查看动态库是否存在

bash 复制代码 
ls /lib64/mysql/

查看MySQL相应的头文件是否存在

bash 复制代码 
ls /usr/include/mysql

如果不存在，需要安装一下

sql 复制代码 
 yum install -y mysql-devel

下面先通过调用mysql_get_client_info来判断库是否引入成功，该函数的作用就是获取客户端的版本信息

cpp 复制代码 
#include <iostream>
#include <mysql/mysql.h>

int main()
{
    std::cout << "mysql client version: " << mysql_get_client_info() << std::endl;
    return 0;
}

进行编译

bash 复制代码 
g++ -o mysql mysql.cpp -L/lib64/mysql -lmysqlclient
  • -L：用于指定库文件的搜索路径
  • -l：用于指明需要连接库文件路径下的哪一个库（L的小写）

这些在动静态库那里都讲过了，不再解释

运行可执行程序后，可以看到客户端的版本号

至此库已经成功被引入，接下来就是库函数的使用了

二、MySQL的C接口介绍

2.1 连接MySQL

1、初始化

在连接数据库之前，需要先创建一个MySQL对象，进行初始化

该函数如下：

c 复制代码 
MYSQL* mysql_init(MYSQL *mysql);

说明：

  • 该函数用来分配或者初始化一个MySQL对象
  • 如果传入参数为NULL，mysql_init将自动分配一个MYSQL对象（句柄）并返回
  • 如果传入的是一个MYSQL对象，该函数会对该对象进行初始化

MYSQL是一个结构体，定义如下：

2、连接数据库

初始化完毕之后，必须先链接数据库，才能进行后续操作（mysql网络部分是基于TCP/IP的）

连接数据库的函数如下：

c 复制代码 
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 clientflag);

参数说明：

  • mysql：表示在连接数据库前，调用mysql_init函数创建的MYSQL对象
  • host：表示需要连接的MySQL服务器的IP地址，"127.0.0.1"表示连接本地MySQL服务器
  • user：表示连接MySQL服务器时，登录所使用的用户名
  • passwd：表示连接MySQL服务器时，登录所使用用户的密码
  • db：表示连接MySQL服务器后，需要使用的是哪一个数据库
  • port：表示连接的MySQL服务器，所对应的端口号
  • unix_socket：表示连接时应该使用的套接字或命名管道，通常设置为NULL
  • clientflag：可以设置为多个标志位的组合，表示允许特定的功能，通常设置为0

返回值

  • 如果连接数据库成功，则返回一个MYSQL对象（句柄），该对象与第一个参数mysql相同
  • 如果连接数据库失败，则返回NULL

3、关闭数据库连接

与数据库交互完毕后，需要关闭数据库连接

关闭数据库连接的函数如下：

c 复制代码 
void mysql_close(MYSQL *sock);

说明：

  • 参数sock，就是连接数据库前调用mysql_init创建的MySQL对象，传入该对象即可

连接测试

代码如下：

cpp 复制代码 
#include <iostream>
#include <string>
#include <mysql/mysql.h>
using namespace std;

const string host = "127.0.0.1";
const string user = "fengye";
const string password = "123123aa";
const string db = "test_db";
const int port = 3306;

int main()
{
    // 1.初始化
    MYSQL* my = mysql_init(nullptr);
    // 2.连接数据库
    if(mysql_real_connect(my, host.c_str(), user.c_str(), password.c_str(), db.c_str(), port, nullptr, 0) == nullptr)
    {
        cerr << "数据库连接失败！" << endl;
        return 1;
    }
    cout << "连接成功" << endl;
    // 3.关闭连接
    mysql_close(my);
    
    return 0;
}

进行编译运行，数据库连接成功

2.2 发送SQL请求

数据库连接成功了，就可以进行进行发送SQL请求了

设置编码格式

在连接数据库之后，需要统一客户端和服务器的编码格式，避免在数据交互过程中出现乱码，设置编码格式的函数如下：

c 复制代码 
int mysql_set_character_set(MYSQL *mysql, const char *csname);

说明：

  • 参数mysql：是mysql_init函数创建初始化的MYSQL对象
  • csname：表示要设置的编码格式，如"utf8"

返回值：为0表示设置成功，否则表示设置失败

注：设置链接原始默认字符集是latin1

发送SQL请求

下发SQL请求的函数如下：

c 复制代码 
int	mysql_query(MYSQL *mysql, const char *q);

说明：

  • mysql：是mysql_init函数创建初始化的MYSQL对象
  • q： 表示向MySQL服务器下发的SQL请求，SQL最后可以不带分号，也可以带

返回值：为0表示SQL执行成功，否则表示SQL执行失败

向数据库中插入数据

cpp 复制代码 
#include <iostream>
#include <string>
#include <mysql/mysql.h>
using namespace std;

const string host = "127.0.0.1";
const string user = "fengye";
const string password = "123123aa";
const string db = "test_db";
const int port = 3306;

int main()
{
    // 1.初始化
    MYSQL* my = mysql_init(nullptr);
    // 2.连接数据库
    if(mysql_real_connect(my, host.c_str(), user.c_str(), password.c_str(), db.c_str(), port, nullptr, 0) == nullptr)
    {
        cerr << "数据库连接失败！" << endl;
        return 1;
    }
    cout << "连接成功" << endl;

    // 设置编码格式
    mysql_set_character_set(my, "utf8");

    string sql = "insert into user (name, age) values ('王五', 19);";
    if(mysql_query(my, sql.c_str()) != 0)
    {
        cerr << sql << " failed." << endl;
        return 2;
    }
    cout << sql << " sucsess." << endl;
    // 3.关闭连接
    mysql_close(my);
    
    return 0;
}

编译运行

删除数据库中的数据

进行删除数据测试

编译运行

修改数据库中的数据

进行修改数据库数据测试

编译运行

2.3 获取结果集

  • 对数据库中的数据进行增删改操作时，都只需要调用mysql_query向服务器下发对应的SQL请求，即不需要返回结果
  • 对于数据库中的数据进行查询操作时，除了需要调用mysql_query向服务器下发对应的查询SQL，还需要获取查询结果，把MySQL服务器查到的数据获取过来

获取查询结果的函数如下：

c 复制代码 
MYSQL_RES* mysql_store_result(MYSQL *mysql);

注：

  • 获取到的查询结果保存到MYSQL_RES变量中
  • 该函数malloc了一片内存空间来存储查询过来的数据，需要进行释放该空间，否则会造成内存泄漏

MYSQL_RES是一个结构体，定义如下：

释放结果集函数：

c 复制代码 
void mysql_free_result(MYSQL_RES *result);

说明：参数传入结果集即可

获取结果集成功后，需要获取结果集的行数和列数，方便进行遍历数据

获取查询结果的行数

获取查询结果的行数的函数如下：

c 复制代码 
my_ulonglong mysql_num_rows(MYSQL_RES *res);

获取查询结果的列数

获取查询结果的列数的函数如下：

c 复制代码 
unsigned int mysql_num_fields(MYSQL_RES *res);

获取查询结果中的一行数据

c 复制代码 
MYSQL_ROW mysql_fetch_row(MYSQL_RES *result);

注：

  • 该函数将会从指定的MYSQL_RES对象中，获取查询结果中的一行数据

获取列名

获取查询结果的列属性的函数如下：

c 复制代码 
MYSQL_FIELD* mysql_fetch_fields(MYSQL_RES *res);

注：

  • 列属性也是需要进行特定获取的
  • 每个MYSQL_FIELD对象中保存着对应列的各种列属性
  • 我们需要获取列名称，即name

MYSQL_FIELD结构体定义如下：

遍历结果集类似于遍历二维数组

查询演示

cpp 复制代码 
#include <iostream>
#include <string>
#include <mysql/mysql.h>
using namespace std;

const string host = "127.0.0.1";
const string user = "fengye";
const string password = "123123aa";
const string db = "test_db";
const int port = 3306;

int main()
{
    // 1.初始化
    MYSQL* my = mysql_init(nullptr);
    // 2.连接数据库
    if(mysql_real_connect(my, host.c_str(), user.c_str(), password.c_str(), db.c_str(), port, nullptr, 0) == nullptr)
    {
        cerr << "数据库连接失败！" << endl;
        return 1;
    }
    cout << "连接成功" << endl;

    // 设置编码格式
    mysql_set_character_set(my, "utf8");

    // string sql = "insert into user (name, age) values ('王五', 19);";
    // string sql = "delete from user where id=4";
    // string sql = "update user set age=66 where id=1";
    string sql = "select * from user";
    if(mysql_query(my, sql.c_str()) != 0)
    {
        cerr << sql << " failed." << endl;
        return 2;
    }
    cout << sql << " sucsess." << endl;

    // 获取结果集
    MYSQL_RES* res = mysql_store_result(my);
    int row = mysql_num_rows(res);   // 数据行数
    int col = mysql_num_fields(res); // 数据列数
    
    // 获取每列的属性，并打印
    MYSQL_FIELD* fields = mysql_fetch_field(res);
    for(int i = 0; i < col; ++i)
    {
        cout << fields[i].name << "\t";
    }
    cout << endl;

    // 遍历数据
    for(int i = 0; i < row; ++i)
    {
        // 获取每一行
        MYSQL_ROW rows = mysql_fetch_row(res);
        for(int j = 0; j < col; ++j)
        {
            cout << rows[j] << "\t";
        }
        cout << endl;
    }

    // 释放res
    mysql_free_result(res);

    // 3.关闭连接
    mysql_close(my);
    
    return 0;
}

编译运行，数据成功被获取出来

  • 再说一下结果集，结果集指向一个数组，数组里面存放的都是char**的指针
  • 使用mysql_fetch_row函数获取一行，返回的结果实际是char**，char**又指向一个char*的数组

    --------------------- END ----------------------
cpp 复制代码 
「 作者 」 枫叶先生
「 更新 」 2023.9.14
「 声明 」 余之才疏学浅，故所撰文疏漏难免，
          或有谬误或不准确之处，敬请读者批评指正。
相关推荐
C吴新科4 小时前
MySQL入门操作详解
mysql
闲晨4 小时前
C++ 继承：代码传承的魔法棒，开启奇幻编程之旅
java·c语言·开发语言·c++·经验分享
Ai 编码助手7 小时前
MySQL中distinct与group by之间的性能进行比较
数据库·mysql
白云如幻7 小时前
MySQL排序查询
数据库·mysql
苹果醋37 小时前
Java8-＞Java19的初步探索
java·运维·spring boot·mysql·nginx
风和先行8 小时前
adb 命令查看设备存储占用情况
android·adb
stars_User8 小时前
MySQL数据库面试题（下）
数据库·mysql
Yaml49 小时前
智能化健身房管理：Spring Boot与Vue的创新解决方案
前端·spring boot·后端·mysql·vue·健身房管理
yanwushu9 小时前
Xserver v1.4.2发布，支持自动重载 nginx 配置
mysql·nginx·php·个人开发·composer
蓝眸少年CY9 小时前
MySQL 【流程控制】函数
mysql
热门推荐
01如何才能让手机厂商主动拥抱华为，接入鸿蒙系统？02【HarmonyOS】HUAWEI DevEco Studio 下载地址汇总03组基轨迹建模 GBTM的介绍与实现（Stata 或 R）04【TC3xx芯片】TC3xx芯片电源管理系统PMS详解05基于YOLOv10深度学习的CT扫描图像肾结石智能检测系统【python源码+Pyqt5界面+数据集+训练代码】深度学习实战、目标检测06【经验分享】Ubuntu22.04安装微信(linux官方版)07Macbook pro M1 安装Ubuntu教程08RAG 实践- Ollama+RagFlow 部署本地知识库09Windows10安装PCL1.14.0及点云配准10文件或文件夹名称中有空格如何批量去除