MySQL 的 C 语言接口

1. mysql_init

MYSQL *mysql_init(MYSQL *mysql);

mysql_init函数的作用:创建一个 MYSQL 对象(该对象用于连接数据库)。

mysql_init函数的参数:

① mysql:MYSQL 结构体指针,一般设置为 NULL 。

mysql_init函数的返回值:

① 成功,返回一个指向 MYSQL 对象的指针。

② 失败,返回 NULL 。

MYSQL 对象的定义如下:

typedef struct st_mysql

{

  NET                net;                        /* Communication parameters */

  unsigned char        *connector_fd;                /* ConnectorFd for SSL */

  char                *host,*user,*passwd,*unix_socket,*server_version,*host_info;

  char          *info, *db;

  struct charset_info_st *charset;

  MYSQL_FIELD        *fields;

  MEM_ROOT        field_alloc;

  my_ulonglong affected_rows;

  my_ulonglong insert_id;                /* id if insert on table with NEXTNR */

  my_ulonglong extra_info;                /* Not used */

  unsigned long thread_id;                /* Id for connection in server */

  unsigned long packet_length;

  unsigned int        port;

  unsigned long client_flag,server_capabilities;

  unsigned int        protocol_version;

  unsigned int        field_count;

  unsigned int         server_status;

  unsigned int  server_language;

  unsigned int        warning_count;

  struct st_mysql_options options;

  enum mysql_status status;

  my_bool        free_me;                /* If free in mysql_close */

  my_bool        reconnect;                /* set to 1 if automatic reconnect */

 

  /* session-wide random string */

  char                scramble[SCRAMBLE_LENGTH+1];

  my_bool unused1;

  void *unused2, *unused3, *unused4, *unused5;

 

  LIST  *stmts;                     /* list of all statements */

  const struct st_mysql_methods *methods;

  void *thd;

  /*

    Points to boolean flag in MYSQL_RES  or MYSQL_STMT. We set this flag

    from mysql_stmt_close if close had to cancel result set of this object.

  */

  my_bool *unbuffered_fetch_owner;

  /* needed for embedded server - no net buffer to store the 'info' */

  char *info_buffer;

  void *extension;

} MYSQL;

MYSQL 对象里有很多连接基本参数,它也包含了一个叫 st_mysql_methods 的结构体变量,该变量里面保存着很多函数指针,这些函数指针将会在数据库连接成功以后的各种数据操作中被调用。

2. mysql_real_connect

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_real_connect函数的作用:连接数据库。

mysql_real_connect函数的参数:

① mysql:MYSQL 对象指针。

② host:要连接的 MySQL 服务器的 IP 地址。

③ user:用户名,以哪个用户身份连接。

④ passwd:用户密码。

⑤ db:要连接的数据库。

⑥ port:要连接的 MySQL 服务器的端口号。

⑦ unix_socket:通常设置为 NULL 。

⑧ clientflag:通常设置为 0 。

mysql_real_connect函数的返回值:

① 成功,返回一个指向 MYSQL 对象的指针,与第一个参数 mysql 的值相同。

② 失败,返回 NULL 。

3. mysql_close

void mysql_close(MYSQL *sock);

mysql_close函数的作用:关闭数据库连接。

mysql_close函数的参数:

① sock:MYSQL 对象指针。

mysql_close函数的返回值:无。

4. mysql_set_character_set

在连接数据库之后,需要先统一客户端和服务器的编码格式,避免在数据交互的过程中出现乱码。
int mysql_set_character_set(MYSQL *mysql, const char *csname);

mysql_set_character_set函数的作用:设置编码格式。

mysql_set_character_set函数的参数:

① mysql:MYSQL 对象指针。

② csname:要设置成哪种字符集。

mysql_set_character_set函数的返回值:

① 成功,为 0 。

② 失败,为非 0 。

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

mysql_query函数的作用:下发 SQL 请求。

mysql_query函数的参数:

① mysql:MYSQL 对象指针。

② q:要执行的 SQL 语句(语句结尾可以不带分号)。

mysql_query函数的返回值:

① 成功,为 0 。

② 失败,为非 0 。

6. mysql_store_result
MYSQL_RES *mysql_store_result(MYSQL *mysql);

mysql_store_result函数的作用:获取查询结果。

mysql_store_result函数的参数:

① mysql:MYSQL 对象指针。

mysql_store_result函数的返回值:

① 成功,返回一个指向 MYSQL_RES 对象的指针。

② 失败,返回 NULL 。

该函数会调用 MYSQL 变量中的 st_mysql_methods 中对应的函数指针来获取查询结果。

该函数会 malloc 出一个 MYSQL_RES 结构体变量,将获取到的查询结果保存到该变量中,最后返回该变量的指针。

由于 MYSQL_RES 的内存空间是 malloc 出来的,所以在使用完之后一定要记得调用 free 函数(mysql_free_result函数)来释放对应的内存空间,否则会造成内存泄漏。

执行完mysql_store_result以后,其实要查询的数据都已经在 MYSQL_RES 变量中了,下面的函数基本就是读取 MYSQL_RES 中的数据,参数都是 MYSQL_RES 对象指针:

// 获取结果的行数

my_ulonglong mysql_num_rows(MYSQL_RES *res);

// 获取结果的列数

unsigned int mysql_num_fields(MYSQL_RES *res);

// 获取结果的列属性

MYSQL_FIELD *mysql_fetch_fields(MYSQL_RES *res);

// 获取结果中的一行记录

MYSQL_ROW mysql_fetch_row(MYSQL_RES *result);

关于mysql_fetch_row函数的返回值 MYSQL_ROW:

MYSQL_ROW,即结果中的一行记录,对应着多个列信息,实际上就是一个字符串数组,因此,MYSQL_ROW 类型,本质就是 char** 类型,其定义如下:

typedef char **MYSQL_ROW;                /* return data as array of strings */

7.mysql_free_result()

void mysql_free_result(MYSQL_RES *result);

作用:用于释放前面 mysql_store_result 分配的内存。

三、使用示例

1.连接数据库和关闭数据库连接

#include <stdio.h>

#include <winsock.h>

#include <mysql.h>

const char host[] = "127.0.0.1";        // MySQL所在机器的ip

const int port = 0;                                        // MySQL所在机器的端口

const char db[] = "test";                        // 数据库名

const char user[] = "root";                        // 用户名

const char passwd[] = "test123";        // 用户密码

int main()

{

//1、获取MySQL实例(相当于创建了一个MySQL句柄)

MYSQL* ms = mysql_init(nullptr);

//2、连接数据库

if(mysql_real_connect(ms, host, user, passwd, db, port, nullptr, 0) == nullptr) {

printf("数据库连接失败!\n");

return 1;

}

printf("数据库连接成功!\n");

//3、访问数据库

//4、关闭数据库连接

mysql_close(ms);

printf("数据库连接关闭成功!\n");

return 0;

}

2.访问数据库

mysql_query

#include <stdio.h>

#include <winsock.h>

#include <mysql.h>

 

const char host[] = "127.0.0.1";        // MySQL所在机器的ip

const int port = 0;                                        // MySQL所在机器的端口

const char db[] = "test";                        // 数据库名

const char user[] = "root";                        // 用户名

const char passwd[] = "test123";        // 用户密码

 

int main()

{

//1、获取MySQL实例(相当于创建了一个MySQL句柄)

MYSQL* ms = mysql_init(nullptr);

 

//2、连接数据库

if(mysql_real_connect(ms, host, user, passwd, db, port, nullptr, 0) == nullptr) {

printf("数据库连接失败!\n");

return 1;

}

//设置连接的编码格式

mysql_set_character_set(ms, "utf8");

 

printf("数据库连接成功!\n");

 

//3. 访问数据库

//3.1 select 其实是最不好处理的!select sql执行完只是第一步,还需要对数据进一步解析

char sql[] = "select * from orderitems;";

int code = mysql_query(ms, sql);

if(code != 0){

printf("execute: %s failed\n", sql);

return 2;

}

printf("execute: %s success\n", sql);

 

//3.2 解析数据 -- 获取行号和列号

MYSQL_RES *result = mysql_store_result(ms);

int rows = mysql_num_rows(result);

int cols = mysql_num_fields(result);

printf("行数:%d,列数:%d\n", rows, cols);

 

//3.3 解析数据 -- 获取表中列名 -- 一般不用,仅仅是为了测试代码的完整性

MYSQL_FIELD *fields = mysql_fetch_fields(result);

for(int i = 0; i < cols; i++){

printf("%s\t", fields[i].name);

}

printf("\n");

 

//3.4 解析数据 -- 获取表中的数据 -- 重要

for(int i = 0; i < rows; i++){

MYSQL_ROW line = mysql_fetch_row(result);  // 获取完整的一行记录(默认从前往后)

for(int j = 0; j < cols; j++){

printf("%s\t", line[j]);  // 将一行记录内部的多列字符串依次打印

}

printf("\n");

}

 

mysql_free_result(result); // 释放内存空间

 

//4、关闭数据库连接

mysql_close(ms);

printf("数据库连接关闭成功!\n");

return 0;

}

#include <stdio.h>

#include <winsock.h>

#include <mysql.h>

 

const char host[] = "127.0.0.1";        // MySQL所在机器的ip

const int port = 0;                                        // MySQL所在机器的端口

const char db[] = "test";                        // 数据库名

const char user[] = "root";                        // 用户名

const char passwd[] = "test123";        // 用户密码

 

// 查询表的内容

int select(MYSQL* ms)

{

//3.1 select 其实是最不好处理的!select sql执行完只是第一步,还需要对数据进一步解析

char sql[] = "select * from man;";

int code = mysql_query(ms, sql);

if(code != 0){

printf("execute: %s failed\n", sql);

return 2;

}

printf("execute: %s success\n", sql);

 

//3.2 解析数据 -- 获取行号和列号

MYSQL_RES *result = mysql_store_result(ms);

int rows = mysql_num_rows(result);

int cols = mysql_num_fields(result);

printf("行数:%d,列数:%d\n", rows, cols);

 

//3.3 解析数据 -- 获取表中列名 -- 一般不用,仅仅是为了测试代码的完整性

MYSQL_FIELD *fields = mysql_fetch_fields(result);

for(int i = 0; i < cols; i++){

printf("%s\t", fields[i].name);

}

printf("\n");

 

//3.4 解析数据 -- 获取表中的数据 -- 重要

for(int i = 0; i < rows; i++){

MYSQL_ROW line = mysql_fetch_row(result);  // 获取完整的一行记录(默认从前往后)

for(int j = 0; j < cols; j++){

printf("%s\t", line[j]);  // 将一行记录内部的多列字符串依次打印

}

printf("\n");

}

 

mysql_free_result(result); // 释放内存空间

return 0;

}

 

int main()

{

//1、获取MySQL实例(相当于创建了一个MySQL句柄)

MYSQL* ms = mysql_init(nullptr);

 

//2、连接数据库

if(mysql_real_connect(ms, host, user, passwd, db, port, nullptr, 0) == nullptr) {

printf("数据库连接失败!\n");

return 1;

}

//设置连接的编码格式

mysql_set_character_set(ms, "gb2312");

 

printf("数据库连接成功!\n");

 

//3. 访问数据库

select(ms);        

 

// insert 操作

char sql_insert[] = "insert into man values (\'小刚\', 19);";

int res = mysql_query(ms, sql_insert);

if(res != 0){

printf("execute: %s failed\n", sql_insert);

return 2;

}

printf("execute: %s success\n", sql_insert);

 

select(ms);

 

//4、关闭数据库连接

mysql_close(ms);

printf("数据库连接关闭成功!\n");

return 0;

}

#include <stdio.h>

#include <winsock.h>

#include <mysql.h>

 

const char host[] = "127.0.0.1";        // MySQL所在机器的ip

const int port = 0;                                        // MySQL所在机器的端口

const char db[] = "test";                        // 数据库名

const char user[] = "root";                        // 用户名

const char passwd[] = "test123";        // 用户密码

 

// 查询表的内容

int select(MYSQL* ms)

{

//3.1 select 其实是最不好处理的!select sql执行完只是第一步,还需要对数据进一步解析

char sql[] = "select * from man;";

int code = mysql_query(ms, sql);

if(code != 0){

printf("execute: %s failed\n", sql);

return 2;

}

printf("execute: %s success\n", sql);

 

//3.2 解析数据 -- 获取行号和列号

MYSQL_RES *result = mysql_store_result(ms);

int rows = mysql_num_rows(result);

int cols = mysql_num_fields(result);

printf("行数:%d,列数:%d\n", rows, cols);

 

//3.3 解析数据 -- 获取表中列名 -- 一般不用,仅仅是为了测试代码的完整性

MYSQL_FIELD *fields = mysql_fetch_fields(result);

for(int i = 0; i < cols; i++){

printf("%s\t", fields[i].name);

}

printf("\n");

 

//3.4 解析数据 -- 获取表中的数据 -- 重要

for(int i = 0; i < rows; i++){

MYSQL_ROW line = mysql_fetch_row(result);  // 获取完整的一行记录(默认从前往后)

for(int j = 0; j < cols; j++){

printf("%s\t", line[j]);  // 将一行记录内部的多列字符串依次打印

}

printf("\n");

}

 

mysql_free_result(result); // 释放内存空间

return 0;

}

 

int main()

{

//1、获取MySQL实例(相当于创建了一个MySQL句柄)

MYSQL* ms = mysql_init(nullptr);

 

//2、连接数据库

if(mysql_real_connect(ms, host, user, passwd, db, port, nullptr, 0) == nullptr) {

printf("数据库连接失败!\n");

return 1;

}

//设置连接的编码格式

mysql_set_character_set(ms, "gb2312");

 

printf("数据库连接成功!\n");

 

//3. 访问数据库

select(ms);        

 

// delete 操作

char sql_delete[] = "delete from man where name=\'小刚\'";

int res = mysql_query(ms, sql_delete);

if(res != 0){

printf("execute: %s failed\n", sql_delete);

return 2;

}

printf("execute: %s success\n", sql_delete);

 

select(ms);

 

//4、关闭数据库连接

mysql_close(ms);

printf("数据库连接关闭成功!\n");

return 0;

}

#include <stdio.h>

#include <winsock.h>

#include <mysql.h>

 

const char host[] = "127.0.0.1";        // MySQL所在机器的ip

const int port = 0;                                        // MySQL所在机器的端口

const char db[] = "test";                        // 数据库名

const char user[] = "root";                        // 用户名

const char passwd[] = "test123";        // 用户密码

 

// 查询表的内容

int select(MYSQL* ms)

{

//3.1 select 其实是最不好处理的!select sql执行完只是第一步,还需要对数据进一步解析

char sql[] = "select * from man;";

int code = mysql_query(ms, sql);

if(code != 0){

printf("execute: %s failed\n", sql);

return 2;

}

printf("execute: %s success\n", sql);

 

//3.2 解析数据 -- 获取行号和列号

MYSQL_RES *result = mysql_store_result(ms);

int rows = mysql_num_rows(result);

int cols = mysql_num_fields(result);

printf("行数:%d,列数:%d\n", rows, cols);

 

//3.3 解析数据 -- 获取表中列名 -- 一般不用,仅仅是为了测试代码的完整性

MYSQL_FIELD *fields = mysql_fetch_fields(result);

for(int i = 0; i < cols; i++){

printf("%s\t", fields[i].name);

}

printf("\n");

 

//3.4 解析数据 -- 获取表中的数据 -- 重要

for(int i = 0; i < rows; i++){

MYSQL_ROW line = mysql_fetch_row(result);  // 获取完整的一行记录(默认从前往后)

for(int j = 0; j < cols; j++){

printf("%s\t", line[j]);  // 将一行记录内部的多列字符串依次打印

}

printf("\n");

}

 

mysql_free_result(result); // 释放内存空间

return 0;

}

 

int main()

{

//1、获取MySQL实例(相当于创建了一个MySQL句柄)

MYSQL* ms = mysql_init(nullptr);

 

//2、连接数据库

if(mysql_real_connect(ms, host, user, passwd, db, port, nullptr, 0) == nullptr) {

printf("数据库连接失败!\n");

return 1;

}

//设置连接的编码格式

mysql_set_character_set(ms, "gb2312");

 

printf("数据库连接成功!\n");

 

//3. 访问数据库

select(ms);        

 

// update 操作

char sql_update[] = "update man set age = 20 where name=\'小明\'";

int res = mysql_query(ms, sql_update);

if(res != 0){

printf("execute: %s failed\n", sql_update);

return 2;

}

printf("execute: %s success\n", sql_update);

 

select(ms);

 

//4、关闭数据库连接

mysql_close(ms);

printf("数据库连接关闭成功!\n");

return 0;

}

  • 执行 update 操作:
  • 执行 delete 操作:
  • 执行 insert 操作:
  • 执行 select 操作:
  • 2
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 1
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值