下载Mysql的C接口库

要使用C语言连接mysql,需要使用mysql官网提供的库,大家可以官网下载,实际上连接数据库的功能在mysql 8.0版本之后已经集成在安装包里面了

链接:https://dev.mysql.com/downloads/

将下载好的压缩包传送到 Linux服务器,进行解压

程序中引入Mysql头文件和库文件

1)压缩包解压之后最重要的两个文件夹:include,lib

2)如何使mysql头文件和库文件引入到项目中

• 方法1:将下载好的头文件和库文件放在系统默认的头文件和库文件路径下
• 方法2:将下载好的头文件和库文件拷贝到当前工作目录下面(有点挫)
• 方法3:建立软连接

这里选择方法3:

代码测试:

mysq_ops.cc

#include<iostream>
#include"./include/mysql.h"
int main()
{ 
      
    //显示MySQL客户端库版本
    std::cout << "mysql client version: " << mysql_get_client_info() << std::endl;
    return 0;
}

Makefile

其中: -I ：指定头文件搜索路径 -L : 指定库文件搜索路径

-l : 指明需要链接库文件路径下的哪一个库(lib目录下面有很多 .a的库) ,去掉前缀和后缀就是库名字

mysql_ops:mysql_ops.cc
	g++ -o $@ $^ -std=c++11 -I./include -L./lib -lmysqlclient
.PHONY:clean
clean:
	rm -f mysql_ops

Mysql接口介绍

创建句柄

初始化:mysql_init(),

要使用库,必须先进行初始化 由此也可以看出MySQL其实是网络服务,句柄就是文件描述符,

MYSQL *my = mysql_init(nullptr);

链接数据库

链接数据库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);

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

mysql_real_connect函数中各参数,基本都是顾名思意

//1.连接MYSQL
const char* host   = "127.0.0.1";
const char* user   = "test";
const char* passwd = "C++Mango...";
const char* db     = "db_test";
const char* port   = 3306;
if (mysql_real_connect(my, host, user, passwd, db, port, nullptr, 0) == nullptr) { 
   
    std::cout << "connect failed" << std::endl; //返回空表示链接失败
    exit(1);
}
std::cout << "connect success" << std::endl;

设置字符编码

更改编码格式

建立好链接之后,获取英文没有问题,如果获取中文是乱码,因为原始默认字符集是latin1,我们要手动设置链接的默认字符集是utf8

mysql_set_character_set(my, "utf8"); //第一个参数是mysql_init的返回值

执行SQL语句

下发mysql命令 mysql_query()

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

第一个参数就是mysql_init的返回值,第二个参数为要执行的sql语句,如“select * from table” 这里不需要加;作为sql语句的结尾

注意:sql执行完以后,如果是select查询,我们当然还要读取数据,如果update,insert等语句就看下操作成功与否即可

• 该函数:返回值为0表示成功,非0表示失败,

//3. 执行SQL语句
// 增删改
std::string sql = "insert into account values (5, '猪八戒', 8.22)";
std::string sql = "delete from account where id=5";
std::string sql = "update account set name='唐僧' where id=5";
// 查
std::string sql = "select * from account";

int res = mysql_query(my, sql.c_str());
if (res != 0) { 
   
    std::cout << "execute: " << sql << " failed" << std::endl;
    exit(2);
}

查询结果

1)如果mysql_query返回成功,那么我们就通过mysql_store_result这个函数来读取结果

MYSQL_RES *mysql_store_result(MYSQL *mysql);

• 依靠句柄获取最新一次查询结果,返回到MYSQL_RES结构体中,同时该函数malloc了一块内存空间来存储查询过来的数据,所以一定要释放对应空间不然会造成内存泄漏

该函数会调用MYSQL变量中的st_mysql_methods中的 read_rows 函数指针来获取查询的结果,同时该函数会返回MYSQL_RES 这样一个变量,该变量主要用于保存查询的结果,同时该函数malloc了一片内存空间来存储查询过来的数据,所以我们一定要记得要 free(mysql_store_result),不然是肯定会造成内存泄漏的, 执行完mysql_store_result以后,其实数据都已经在MYSQL_RES 变量中了,下面的api基本就是读取MYSQL_RES 中的数据,

2)获取结果行数mysql_num_rows

my_ulonglong mysql_num_rows(MYSQL_RES *res);

3)获取结果列数mysql_num_fifields

unsigned int mysql_num_fields(MYSQL_RES *res);

4)获取列名(字段名称)mysql_fetch_fifields

MYSQL_FIELD *mysql_fetch_fields(MYSQL_RES *res);

例子:

int fields = mysql_num_fields(res); //获取有多少列
MYSQL_FIELD *field = mysql_fetch_fields(res);//获取列名
for(int i = 0; i < fields; i++) //输出列名
    cout<<field[i].name<<" ";

5)获取结果内容mysql_fetch_row (获取一行完整的记录)

MYSQL_ROW mysql_fetch_row(MYSQL_RES *result);

它会返回一个MYSQL_ROW类型的变量, MYSQL_ROW本质就是char**类型,当成一个二维数组来用

例子:

//遍历获取记录
for (int i = 0; i < rows; i++)  //行数 :rows
{ 
   
    MYSQL_ROW line = mysql_fetch_row(result);//获取完整的一行的记录
    for (int j = 0; j < cols; j++)  //列数:cols
    { 
   
        std::cout << line[j] << "\t";//打印改行的内容
    }
    std::cout << std::endl;
}

关闭链接

关闭mysql链接mysql_close

void mysql_close(MYSQL *sock);

mysql.ops.cc

#include <iostream>
#include <string>
#include "./include/mysql.h"
 
const std::string host = "175.178.18.99"; //主机号
const std::string user = "test";//用户
const std::string passwd = "C++Mango...";//密码
const std::string db = "db_test"; //要使用的库
const int port = 3306; //端口号
 
int main()
{ 
   
 
    // 相当于给我们创建了一个mysql句柄
    MYSQL *my = mysql_init(nullptr); 
 
    // 链接数据库
    if( nullptr == mysql_real_connect(my, host.c_str(), user.c_str(), passwd.c_str(), db.c_str(), port, nullptr, 0))
    { 
   
        std::cerr << "mysql 连接失败!" << std::endl;
        return 1;
    }
 
    // 设置连接的编码也是utf8
    mysql_set_character_set(my, "utf8");
 
    std::cout << "mysql 连接成功!" << std::endl;
	
    //增删改 这个三个是最简单的,因为只要sql执行完毕,就完成了
    //插入的时候同样会受主键约束之类的
    //std::string sql = "insert into account values (3,\'赵六\',30 )";
    //std::string sql = "update account set blance = 300 where id=3";
    std::string sql = "delete from account where id=3";
    int r = mysql_query(my,sql.c_str());//执行成功 res为0,失败的话res非0
    if(r != 0)
    { 
   
        std::cout << "execute: " << sql.c_str() << " failed!" << std::endl;
        return 2;
    }


    // select语句执行完,只是第一步,还需要对数据进一步解析！
    // 1. 执行查询语句
    std::string select_sql = "select name from account"; //后序只需要更改这个查找,后面的逻辑都不需要变

    if (0 != mysql_query(my, select_sql.c_str()))
    { 
   
        std::cout << "execute: " << select_sql << " failed!" << std::endl;
        return 3;
    }
    std::cout << "execute: [" << select_sql << " ] success" << std::endl;
    
    // 2. 获取查询结果数据
    MYSQL_RES *res = mysql_store_result(my);//获取执行结果
 
    //3.解析数据 -- 获取行数和列数
    int rows = mysql_num_rows(res); // 获取行数
    int cols = mysql_num_fields(res);// 获取列数
    std::cout << "行数: " << rows << ", 列数: " << cols << std::endl;

    // 4.解析数据 -- 获取表中列名 -- 一般不用，仅仅是为了测试代码的完整性
    MYSQL_FIELD *fields = mysql_fetch_field(res);
    for (int i = 0; i < cols; i++)
    { 
   
        // 获取列名，通常没什么用
        std::cout << fields[i].name << "\t";
    }
    std::cout << std::endl;
 
    //5. 解析数据 -- 获取表中的数据 -- 重要
    for(int i = 0; i < rows; i++)
    { 
   
       //获取完整的一行记录[可能包含了多列]
        MYSQL_ROW line = mysql_fetch_row(res);//MYSQL_ROW本质就是二级指针char**
        for(int j = 0; j < cols; j++) 
        { 
   
            std::cout << line[j] << "\t";//将记录内部的多列字符串依次打印！
        }
        std::cout << std::endl;
    }
 
    //最后,关闭shujku
    free(res); //不要忘记释放空间
    mysql_close(my);
    std::cout << "关闭mysql连接" << std::endl;
    return 0;
}