mysql的C语言api函数

这节主要是介绍MySQL的api函数，使用这些api函数可以完成C语言操作MySQL数据库。

初始化连接环境

//参数 mysql为null
//返回值：用于连接MySQL服务器
MYSQL* mysql_init(MYSQL* mysql);

连接MySQL服务器

//返回值与第一个参数类型相同
MYSQL* mysql_real_connect(
	MYSQL* mysql,	//	mysql_init函数的返回值
    const char* host,	//	mysql服务器的ip地址
    const char* user,	//	用户名
    const char* passwd,	//	密码
    const char* db,	//	数据库名
    unsigned int port,	//	端口号，默认为3306
    const char* unix_socket,//本地套接字，不使用指定为null
    unsigned long client_flag//通常指定为0
);

执行sql语句

//执行sql语句
//参数1为mysql_real_connect连接数据库的返回值
//参数2为sql语句，不需要加分号结尾
//执行成功返回0，如果是查询则结果集存放在mysql对象中
//执行失败返回非0值
int mysql_query(MYSQL* mysql,const char* query);

获取结果集

//将查询到的结果集从mysql对象中取出
//MYSQL_RES对应一块存放查询结果集的内存
//将行列中的具体数据取出需要其他函数组合使用
MYSQL_RES* mysql_store_result(MYSQL* mysql);

获取结果集的列数

//参数 调用mysql_tsore_result()的返回值
//返回值 结果集的列数
unsigned int mysql_num_fields(MYSQL_RES* result);

获取表头列名

//返回值MYSQL_FIELD*指向一个结构体数组，通过结构体数组可以获取列名
MYSQL_FIELD* mysql_fetch_fields(MYSQL_RES* result);

获取结果集中字段的长度

//避免使用strlen函数进行计算字段长度
//返回值 成功返回长度，失败返回null
unsigned long* mysql_fetch_lengths(MYSQL_RES* result);

遍历结果集

//遍历结果集的下一行，如需遍历整个结果集，则循环调用当前函数
//返回值为二级指针指向一个指针数组，里面每个元素都是char*类型的指针
//失败返回NULL，说明结果集读取完毕
typedef char** MYSQL_ROW;
MYSQL_ROW mysql_fetch_row(MYSQL_RES* result);

资源回收

//释放结果集
void mysql_free_result(MYSQL_RES* result);
//关闭mysql对象
void mysql_close(MYSQL*mysql);

字符编码

//获取api默认的字符编码
//为当前连接返回默认的字符集
const char* mysql_character_set_name(MYSQL* mysql);

//设置api使用的字符集
//第二个参数就是设置的字符集
int mysql_set_character_set(MYSQL* mysql,char* casname);

事务操作

//MySQL默认会进行事务的提交
//因为自动提交事务会对操作造成影响，所以将提交方式设置为手动。
//模式为1，自动提交；模式为0，手动提交
my_bool mysql_autocommit(MYSQL* mysql,my_bool mode);
//事务提交
//返回值成功0失败非0
my_bool mysql_commit(MYSQL* mysql);
//数据回滚
//返回值成功0失败非0
my_bool mysql_rokkback(MYSQL* mysql);

打印错误信息

//返回错误描述
const char* mysql_error(MYSQL* mysql);
//返回错误编号
unsigned int mysql_errno(MYSQL* mysql);

示例代码

添加头文件

#include<mysql.h>

配置环境：

1. 将在mysql安装目录中的include文件夹的路径添加到VC++目录的包含目录中。
2. 再将lib文件夹路径添加到库目录中。
3. 链接器-输入-附加依赖项，添加libmysql.lib

代码：

#include <stdio.h>
#include <mysql.h>

int main()
{
    // 1. 初始化连接环境
    MYSQL* mysql = mysql_init(NULL);
    if(mysql == NULL)\
    {
        printf("mysql_init() error\n");
        return -1;
    }

    // 2. 连接数据库服务器
    mysql = mysql_real_connect(mysql, "localhost", "root", "root", 
                               "scott", 0, NULL, 0);
    if(mysql == NULL)
    {
        printf("mysql_real_connect() error\n");
        return -1;
    }

    printf("mysql api使用的默认编码: %s\n", mysql_character_set_name(mysql));

    // 设置编码为utf8
    mysql_set_character_set(mysql, "utf8");

    printf("mysql api使用的修改之后的编码: %s\n", mysql_character_set_name(mysql));

    printf("恭喜, 连接数据库服务器成功了...\n");

    // 3. 执行一个sql语句
    // 查询scott数据库下的dept部门表
    const char* sql = "select * from dept";
    // 执行这个sql语句
    int ret = mysql_query(mysql, sql);
    if(ret != 0)
    {
        printf("mysql_query() a失败了, 原因: %s\n", mysql_error(mysql));
        return -1;
    }

    // 4. 取出结果集
    MYSQL_RES* res = mysql_store_result(mysql);
    if(res == NULL)
    {
        printf("mysql_store_result() 失败了, 原因: %s\n", mysql_error(mysql));
        return -1;
    }

    // 5. 得到结果集中的列数
    int num = mysql_num_fields(res);

    // 6. 得到所有列的名字, 并且输出
    MYSQL_FIELD * fields = mysql_fetch_fields(res);
    for(int i=0; i<num; ++i)
    {
        printf("%s\t\t", fields[i].name);
    }
    printf("\n");

    // 7. 遍历结果集中所有的行
    MYSQL_ROW row;
    while( (row = mysql_fetch_row(res)) != NULL)
    {
        // 将当前行中的每一列信息读出
        for(int i=0; i<num; ++i)
        {
            printf("%s\t\t", row[i]);
        }
        printf("\n");
    }

    // 8. 释放资源 - 结果集
    mysql_free_result(res);

    // 9. 写数据库
    // 以下三条是一个完整的操作, 对应的是一个事务
    // 设置事务为手动提交
    mysql_autocommit(mysql, 0); 
    int ret1 = mysql_query(mysql, "insert into dept values(61, '海军', '圣地玛丽乔亚')");
    int ret2 = mysql_query(mysql, "insert into dept values(62, '七武海', '世界各地')");
    int ret3 = mysql_query(mysql, "insert into dept values(63, '四皇', '新世界')");
    printf("ret1 = %d, ret2 = %d, ret3 = %d\n", ret1, ret2, ret3);

    if(ret1==0 && ret2==0 && ret3==0)
    {
        // 提交事务
        mysql_commit(mysql);
    }
    else
    {
        mysql_rollback(mysql);
    }

    // 释放数据库资源
    mysql_close(mysql);
    
  return 0;
}