C语言调用MySQL接口

清疚 2022-05-12 05:46 255阅读 0赞

> 说明：在做一个项目的过程中，用到了这部分知识，个人觉得网上关于这部分的介绍真的比较模糊，就自己总结一下项目中用到的这些接口的使用方法。

### **准备工作** ###

这个项目是在Linux下开发，如果需要使用MySQL关于C语言的接口，首先得包含这个头文件`<mysql.h>`，而这个头文件在Linux系统中默认是没有的，所以首先得先安装：  
//安装MySQL  
`sudo yum -y install mysql-sever mysql-client`  
//安装MySQL开发包  
`sudo yum -y install libmysqlclient-dev`

### **接口使用** ###

> 首先需要引入头文件`<mysql/mysql.h>`

#### 1.定义一个句柄并初始化 ####

*  函数原型：
    
    `MYSQL* mysql_init(MYSQL* connection);`
 *  使用示例：

MYSQL sql;
    mysql_init(&sql);

#### 2.连接MySQL数据库 ####

*  函数原型：

MYSQL* mysql_real_connect( MYSQL* connection,
    							  const char* server_host,
    							  const char* sql_usr_name,
    							  const char* sql_passwd,
    							  const char* db_name,
    							  unsigned int port_num,
    							  const char* unix_socket_name,
    							  unsigned int flags);

*  参数说明：

1.  初始化过的MySQL客户端句柄
2.  MySQL服务器地址（也可以写localhost)
3.  登陆MySQL服务器的用户名
4.  登陆MySQL服务器的密码
5.  数据库名
6.  MySQL服务器的端口号（默认3306）
7.  直接填默认值NULL
8.  一般不关注，填0即可

*  返回值：  
    失败返回NULL
 *  使用示例：

if(!mysql_real_connect(&sql, "localhost", "root", "xxx", "TestDB",
    	3306, NULL, 0){ 
    	fprintf(stderr,\
    			"MySQL connect failed!\nReason:%s\n", \
    			mysql_error(&sql));
    	return 1;
    }

#### 3.错误处理 ####

*  函数原型：  
    `char* mysql_error(MYSQL* connection);`  
    此函数返回错误信息  
    `unsigned int mysql_errno(MYSQL* connection);`  
    此函数返回错误码

#### 4.设置MySQL的默认字符集 ####

> 一般直接向浏览器响应数据时，使用此函数可以避免中文乱码

*  函数原型：  
    `int mysql_set_character_set(MYSQL* connection, char* csname);`
 *  参数说明：  
    1.已经初始化过的MySQL句柄  
    2.需要设置的字符集（中文为`utf8`)
 *  返回值：  
    成功返回0，失败返回非零值
 *  使用示例：

if(mysql_set_character_set(&connection, "utf8")){ 
    	fprintf(errno, "%s\n", mysql_error(&sql));
    	return;
    }

#### 5. 向MySQL发送SQL语句 ####

*  函数原型：  
    `int mysql_query(MYSQL* connection, const char* query);`  
    第二个参数即拼装好的SQL语句，**执行成功**返回0，失败返回非零值。
 *  使用示例：

char query[1024] = "select * from TestDB where id = 1;
    if(mysql_query(&connection, query)){ 
    	fprintf(errno, "%s\n", mysql_error(&connection));
    	return;
    }

#### 6. 接收MySQL返回的结果 ####

**相关函数：**

*  函数原型：  
    `MYSQL_RES *mysql_store_result(MYSQL* connection);`  
    这个函数将立刻保存在客户端中返回的所有数据。它返回一个指向结果集结构的指针，如果失败返回NULL
 *  函数原型：  
    `unsigned int mysql_num_fiedls(MYSQL_RES* result);`  
    获取返回结果集合中每一行的数量（列数）
 *  函数原型：  
    `unsigned int mysql_num_rows(MYSQL_RES* result);`  
    获取返回结果集合中数据的行数
 *  函数原型：  
    `MYSQL_ROW mysql_fetch_row(MYSQL_RES* result);`  
    检索一个结果集合的下一行。当在mysql\_store\_result()之后使用时，如果没有更多的行可检索时，mysql\_fetch\_row()返回NULL

**使用示例：**

MYSQL_RES* result = mysql_store_result(&connection);
    if(NULL == result){ 
    	printf("此次查询失败，结果不存在！\n");
    }else{ 
    	MYSQL_ROW cols = mysql_fetch_row(result);
    	for(unsigned int i = 0; i < mysql_num_fields(result); ++i){ 
    		printf("%s\n",cols[i]);
    	} 
    }

#### 7.关闭和MySQL的连接 ####

*  函数原型：  
    `void mysql_close(MYSQL* connection);`  
    如果忘记关闭连接，会造成MySQL服务器文件描述符泄漏

### 编译链接 ###

假设在`test_mysql.c`中用到了mysql接口，那么编译这个源文件的命令如下：

gcc test_mysql.c -o test_mysql `mysql_config --cflags --libs`

当然，也可以手动指定头文件和库的位置（以博主的开发环境示例）

gcc test_mysql.c -o test_mysql -I /usr/include/mysql -L /usr/lib64/mysql -lmysqlclient