说明:在做一个项目的过程中,用到了这部分知识,个人觉得网上关于这部分的介绍真的比较模糊,就自己总结一下项目中用到的这些接口的使用方法。
准备工作
这个项目是在Linux下开发,如果需要使用MySQL关于C语言的接口,首先得包含这个头文件,而这个头文件在Linux系统中默认是没有的,所以首先得先安装:
//安装MySQL
sudo yum -y install mysql-sever mysql-client
//安装MySQL开发包
sudo yum -y install libmysqlclient-dev
接口使用
首先需要引入头文件
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);
参数说明:
初始化过的MySQL客户端句柄
MySQL服务器地址(也可以写localhost)
登陆MySQL服务器的用户名
登陆MySQL服务器的密码
数据库名
MySQL服务器的端口号(默认3306)
直接填默认值NULL
一般不关注,填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