【MySQL】使用C语言连接数据库

       看到标题，可能会疑惑，我们学习的不是C++吗，为什么使用C语言去连接数据库呢??实际上，这两种语言都可以连接数据库，但是C语言提供的API没有进行封装，更有利于我们学习数据库连接。面向API编程，哈哈哈哈哈哈！！！！！

一、安装适合自己平台的mysql connect库

       因为我使用的是Ubuntu，所以在这里就只介绍在Ubuntu中如何下载mysql connect库。在Ubuntu下载这个库还是比较简单的，只有几个指令执行就可以了。

更新包信息

sudo apt update

安装 MySQL 服务器

sudo apt install mysql-server

在Ubuntu中，MySQL的头文件和库文件通常位于以下位置：

• 头文件（如mysql.h）：/usr/include/mysql/
• 库文件：/usr/lib/x86_64-linux-gnu/（或者/usr/lib/，具体路径可能根据系统架构而异）

如果你需要这些文件，可以通过安装libmysqlclient-dev包来获得它们：

sudo apt install libmysqlclient-dev

这会将头文件和库文件安装到系统的标准位置。

       为了检查我们是否已经安装成功，我们可以使用mysql_get_client_info()函数尝试连接mysql client。注意在连接之前，确保自己的服务器是打开状态。

#include <iostream>
#include <string>
#include <mysql/mysql.h>

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

// Makefile写法
connect : connect.cc 
	g++ -o $@ $^ -lmysqlclient -std=c++11

.PHONY:clean
cleam: 
	rm -f connect

二、mysql接口介绍

2.1 mysql_init()  初始化函数

       如果想要使用数据库，我们需要先进行初始化！创建出数据库句柄，之后的函数调用需要使用它！！

函数原型：

MYSQL *mysql_init(MYSQL *mysql);

代码示例： 

MYSQL *mfp = mysql_init(nullptr); // 大型结构体
if (mfp == nullptr)
{
    std::cerr << "init mysql error" << std::endl;
    return -1;
}

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

参数说明：

1. *MYSQL mysql：指向一个已初始化的 MYSQL 结构体的指针，通常使用 mysql_init() 初始化。

2. *const char host：数据库服务器的主机名或 IP 地址，通常为 "localhost" 或者指定的服务器地址。

3. *const char user：用于连接的 MySQL 用户名。

4. *const char passwd：对应用户的密码。

5. *const char db：要连接的数据库名。如果不需要选择特定数据库，可以传递 NULL。

6. unsigned int port：数据库服务器的端口号，默认为 3306。如果使用 Unix socket，通常可以设置为 0。

7. *const char unix_socket：如果使用 Unix socket，可以提供 socket 文件的路径；如果使用 TCP/IP，则可以设置为 NULL。

8. unsigned long client_flag：连接选项的标志位，通常可以设置为 0。

       第一个参数MySQL是C API中一个非常重要的变量（mysql_init的返回值），里面的内存非常丰富，有port，dbname，charset等连接基本参数，他也包含了一个叫做st_mysql_methods的结构体变量，该变量里面保存着很多函数指针，这些函数指针将会在数据库连接成功以后的各种数据操作中被调用。

代码示例：

const std::string host = "127.0.0.1";
const std::string user = "connector";
const std::string passwd = "Hh.123456";
const std::string db = "test";
const unsigned int port = 3306;

if (mysql_real_connect(mfp, host.c_str(), user.c_str(), passwd.c_str(), db.c_str(), 3306, nullptr, 0) == nullptr)
{
    return 2;
}
std::cout << "connect mysql success" << std::endl;

       建立好连接之后，获取英文没有问题，如果获取的中文是乱码，我们可以想到的是字符集没有设置正确，设置连接的默认字符集是utf8，原始默认是latinl

mysql_set_character_set(myfd, "utf8");

2.3 mysql_query()  下发mysl命令

函数原型：

int mysql_query(MYSQL *mysql, const char *q);

       第一个参数上面已经介绍过了，第二个参数要执行的sql语句，比如“select * from table”。

2.4 mysql_store_result()  获取执行结果

       sql执行完以后，如果是查询语句，我们当然还有读取数据，如果update，insert等语句，那么只用看操作成功与否即可。我们来看一看如何获取查询结果的：如果mysql_query返回成功，那么我们就通过mysql_store_result这个函数来读取结果。

函数原型：

MYSQL_RES *mysql_store_result(MYSQL *mysql);

       该函数会调用MySQL变量中的st_mysql_methods中的read_rows函数指针来获取查询的结果。 同时该函数会返回MYSQL_RES这样的变量，该变量主要用于保存查询结果。同时该函数malloc一片内存空间来存储查询过来的数据，所以我们一定要记住free（result），不然会造成内存泄露的，但是在MYSQL中会直接提供  void mysql_free_result(MYSQL_RES *result)    来进行释放空间。执行完mysql_store_result函数以后，其实数据都已经子啊MYSQL_RES变量中。

2.5 mysql_num_row()  获取结果行数

my_ulonglong mysql_num_rows(MYSQL_RES *res);

2.6 mysql_num_fields()  获取结果列数

unsigned int mysql_num_fields(MYSQL_RES *res);

2.7 mysql_fetch_fields()  获取列名

函数原型：

MYSQL_FIELD *mysql_fetch_fields(MYSQL_RES *res);

代码示例： 

int fields = mysql_num_fields(res);
MYSQL_FIELD *field = mysql_fetch_fields(res);
int i = 0;
for(; i < fields; i++){
    cout<<field[i].name<<" ";
}
cout<<endl;

2.8 mysql_fetch_row()  获取结果内容

函数原型：

MYSQL_ROW mysql_fetch_row(MYSQL_RES *result);

       这个函数会返回一个MYSQL_ROW变量，MYSQL_ROW其实就是一个char **，可以将其当成一个二维数组来使用。   

i = 0;
MYSQL_ROW line;
for(; i < nums; i++){
    line = mysql_fetch_row(res);  // 每一次调用都会自己刷新，并指向下一行
    int j = 0;
    for(; j < fields; j++){
        cout<<line[j]<<" ";
    }
    cout<<endl;
}

2.9 mysql_close()  关闭mysql链接

void mysql_close(MYSQL *sock);

2.10 mysql_free_result()  释放mysql空间

       在 MySQL C API 中，mysql_free_result() 函数用于释放与 MYSQL_RES 结构体相关的内存。当你完成对查询结果的处理后，调用此函数可以避免内存泄漏。

函数原型：

void mysql_free_result(MYSQL_RES *result);

参数：

• result：指向要释放的 MYSQL_RES 结构体的指针。

使用示例：

MYSQL_RES *result = mysql_store_result(conn); // 处理结果...
mysql_free_result(result); // 释放内存

       在每次使用 mysql_store_result() 或类似函数后，都应该调用 mysql_free_result() 来清理资源。