MYSQL C API 入门教程

（一）关于本教程

这是一本关于MYQL的C语言编程的入门教程，它讲述了MYSQL的C API编程的基本知识。本博文由编程导航网提供。

（二）关于MYSQL数据库

MYSQL是一个领先的开源数据管理系统，是一个多用户、多线程的数据库系统。MYSQL在web应用中特别流行，是非常流行的LAMP（L-linux, A-apache, M-mysql, P-php）平台中的一部分。MYSQL最早是由瑞典的MYSQL AB公司所开发， 这家公司以及Trolltech 是非常有名的开放源代码公司。MYSQL兼容大多数操作系统平台，包括BSD Unix、Linux、Windows以及MAC。维基百科和YouTube使用MYSQL，这些网站每天处理上百万的查询请求。MYSQL包括两个版本：MYSQL服务端版本和MYSQL嵌入式版本。

（三）第一个示例

第一个示例简单的测试MYSQL的API函数，代码如下：

#include <my_global.h>#include <mysql.h>int main(int argc, char **argv){  printf("MySQL client version: %s\n", mysql_get_client_info());  return 0;}

API mysql_get_client_info获取mysql客户端的版本号，编译：

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

执行程序verion，得出如下输出结果：

 $ ./version

 MySQL client version: 5.0.38

代码详解：

 #include <my_global.h>

 #include <mysql.h>

首先，我们包含必要的头文件myql.h和my_global.h，mysql.h是MYSQL函数调用中要包含的最重要的头文件。my_global.h包含了一些全局函数的声明以及标准输入输出的头文件。

printf("MySQL client version: %s\n", mysql_get_client_info());

这些代码打印了Mysql客户端的版本号，通过使用mysql_get_client_info API调用。

 

（四）创建数据库

以下代码演示如何创建数据库：

#include <my_global.h>#include <mysql.h>int main(int argc, char **argv){  MYSQL *conn;  conn = mysql_init(NULL);  if (conn == NULL) {      printf("Error %u: %s\n", mysql_errno(conn), mysql_error(conn));      exit(1);  }  if (mysql_real_connect(conn, "localhost", "zetcode",           "passwd", NULL, 0, NULL, 0) == NULL) {      printf("Error %u: %s\n", mysql_errno(conn), mysql_error(conn));      exit(1);  }  if (mysql_query(conn, "create database testdb")) {      printf("Error %u: %s\n", mysql_errno(conn), mysql_error(conn));      exit(1);  }  mysql_close(conn);}

以上示例代码先连接到mysql数据库，然后创建一个testdb数据库。现在登录到数据库中验证一下：

mysql> show databases;

+--------------------+

| Database           |

+--------------------+

| information_schema |

| mysql              |

| testdb             |

+--------------------+

3 rows in set (0.00 sec)

经验证，数据库testdb确实已经创建好了。

在这个示例代码中，我们进行了错误检查，进行错误检查是非常重要的，因为数据库编程中有许多地方会出现错误。为了简明起见，后面的示例将忽略错误检查。

本示例代码可以划分为以下几个部分：

1.初始化一个链接结构。

2.创建一个链接。

3.执行查询。

4.关闭链接。

MYSQL* conn;

首先，声明一个conn指针指向一个MYSQL结构体，这个结构体就是一个数据库连接句柄。

conn = mysql_init(NULL);

函数mysql_init将返回一个链接句柄。

 if (conn == NULL) {

     printf("Error %u: %s\n", mysql_errno(conn), mysql_error(conn));

     exit(1);

 }

我们检查函数返回值，如果mysql_init函数执行失败，我们打印错误信息并且结束程序。

if (mysql_real_connect(conn, "localhost", "zetcode", 

         "passwd", NULL, 0, NULL, 0) == NULL) {

     printf("Error %u: %s\n", mysql_errno(conn), mysql_error(conn));

     exit(1);

 }

函数mysql_real_connect建立一个到mysql数据库的链接。调用这个函数要提供 链接句柄、主机名、用户、密码等参数，最后四个参数依次是数据库名、端口、unix套接字和客户端标志。

if (mysql_query(conn, "create database testdb")) {

     printf("Error %u: %s\n", mysql_errno(conn), mysql_error(conn));

     exit(1);

 }

mysql_close(conn);

函数mysql_query执行sql语句，在本示例中，将建立一个新的数据库。最后，我们关闭数据库链接。

 

（五）创建表并且插入数据

本示例将创建一个表并且插入一些数据，示例代码如下：

#include <my_global.h>#include <mysql.h>int main(int argc, char **argv){  MYSQL *conn;  conn = mysql_init(NULL);  mysql_real_connect(conn, "localhost", "zetcode", "passwd", "testdb", 0, NULL, 0);  mysql_query(conn, "CREATE TABLE writers(name VARCHAR(25))");  mysql_query(conn, "INSERT INTO writers VALUES('Leo Tolstoy')");  mysql_query(conn, "INSERT INTO writers VALUES('Jack London')");  mysql_query(conn, "INSERT INTO writers VALUES('Honore de Balzac')");  mysql_query(conn, "INSERT INTO writers VALUES('Lion Feuchtwanger')");  mysql_query(conn, "INSERT INTO writers VALUES('Emile Zola')");  mysql_close(conn);}

在本示例代码中，我们没有使用任何新的mysql API，创建表和插入数据都是使用mysql_query函数。

1.建立链接

mysql_real_connect(conn, "localhost", "zetcode", "passwd", "testdb", 0, NULL, 0);

2.建立writers表，该表只有一列，类型为VARCHAR。

mysql_query(conn, "CREATE TABLE writers(name VARCHAR(25))");

3.插入数据

mysql_query(conn, "INSERT INTO writers VALUES('Leo Tolstoy')");

mysql_query(conn, "INSERT INTO writers VALUES('Jack London')");

mysql_query(conn, "INSERT INTO writers VALUES('Honore de Balzac')");

mysql_query(conn, "INSERT INTO writers VALUES('Lion Feuchtwanger')");

mysql_query(conn, "INSERT INTO writers VALUES('Emile Zola')");

4.验证数据

mysql> select * from writers;

+-------------------+

| name              |

+-------------------+

| Leo Tolstoy       |

| Jack London       |

| Honore de Balzac  |

| Lion Feuchtwanger |

| Emile Zola        |

+-------------------+

5 rows in set (0.00 sec)

5.关闭链接

mysql_close(conn);

（六）从数据库中查询数据

这一节，我们从表中查询数据，分为以下几步：

1.建立一个链接

2.执行查询

3.获取结果集

4.获取所有行

5.释放结果集

6.释放链接

本节示例代码如下：

#include <my_global.h>#include <mysql.h>int main(int argc, char **argv){  MYSQL *conn;  MYSQL_RES *result;  MYSQL_ROW row;  int num_fields;  int i;  conn = mysql_init(NULL);  mysql_real_connect(conn, "localhost", "zetcode", "passwd", "testdb", 0, NULL, 0);  mysql_query(conn, "SELECT * FROM writers");  result = mysql_store_result(conn);  num_fields = mysql_num_fields(result);  while ((row = mysql_fetch_row(result)))  {      for(i = 0; i < num_fields; i++)      {          printf("%s ", row[i] ? row[i] : "NULL");      }      printf("\n");  }  mysql_free_result(result);  mysql_close(conn);}

1.执行查询，并取回writers表中的所有数据：

mysql_query(conn, "SELECT * FROM writers");

2.获取结果集

result = mysql_store_result(conn);

3.获取writers表中的所有字段

num_fields = mysql_num_fields(result);

4.获取每行数据，并且输出到屏幕上

 while ((row = mysql_fetch_row(result)))

  {

      for(i = 0; i < num_fields; i++)

      {

          printf("%s ", row[i] ? row[i] : "NULL");

      }

      printf("\n");

  }

 

5.释放结果集

 mysql_free_result(result);

6.关闭链接

 mysql_close(conn);

（七）列头

在本节中，将演示查询数据并获取表中每一列的名字。

 首先，我们建立一个新的表，并插入些数据：

 mysql> create table friends (id int not null primary key auto_increment,

                               name varchar(20), age int);

 mysql> insert into friends(name, age) values('Tom', 25);

 mysql> insert into friends(name, age) values('Elisabeth', 32);

 mysql> insert into friends(name, age) values('Jane', 22);

 mysql> insert into friends(name, age) values('Luke', 28);

本节示例代码如下：

#include <my_global.h>#include <mysql.h>int main(int argc, char **argv){  MYSQL *conn;  MYSQL_RES *result;  MYSQL_ROW row;  MYSQL_FIELD *field;   int num_fields;  int i;  conn = mysql_init(NULL);  mysql_real_connect(conn, "localhost", "zetcode", "passwd", "testdb", 0, NULL, 0);  mysql_query(conn, "SELECT * FROM friends");  result = mysql_store_result(conn);  num_fields = mysql_num_fields(result);  while ((row = mysql_fetch_row(result)))  {      for(i = 0; i < num_fields; i++)      {          if (i == 0) {             while(field = mysql_fetch_field(result)) {                printf("%s ", field->name);             }          printf("\n");          }         printf("%s  ", row[i] ? row[i] : "NULL");      }  }  printf("\n");  mysql_free_result(result);  mysql_close(conn);}

本节示例代码和上一节类似，只是增加了获取表中列名称的代码：

 while(field = mysql_fetch_field(result)) {

     printf("%s ", field->name);

 }

函数mysql_fetch_field返回一个MYSQL_FIELD结构，从结构中可以获取列的名称。编译后，程序输出如下：

$ ./headers

id name age

1  Tom  25

2  Elisabeth  32

3  Jane  22

4  Luke  28

 

（八）插入图片到Mysql数据库

有人喜欢使用mysql来存储图片，而有的人喜欢把图片存储在文件系统中。而当我们要处理成千上万的图片时，会引起技术问题。图片时二进制数据，mysql有种特殊的数据类型，用来存储二进制数据，叫做BLOB（Binary Large Ojbect）。

mysql> describe images;

+-------+------------+------+-----+---------+-------+

| Field | Type       | Null | Key | Default | Extra |

+-------+------------+------+-----+---------+-------+

| id    | int(11)    | NO   | PRI |         |       |

| data  | mediumblob | YES  |     | NULL    |       |

+-------+------------+------+-----+---------+-------+

2 rows in set (0.00 sec)

这个是本节中我们要使用的表，创建语句如下：

create table images(id int not null primary key, data mediumblob);

以下是本例中所有程序代码：

#include <my_global.h>#include <mysql.h>int main(int argc, char **argv){  MYSQL *conn;  int len, size;  char data[1000*1024];  char chunk[2*1000*1024+1];  char query[1024*5000];  FILE *fp;  conn = mysql_init(NULL);  mysql_real_connect(conn, "localhost", "zetcode", "passwd", "testdb", 0, NULL, 0); fp = fopen("image.png", "rb");  size = fread(data, 1, 1024*1000, fp);  mysql_real_escape_string(conn, chunk, data, size);  char *stat = "INSERT INTO images(id, data) VALUES('1', '%s')";  len = snprintf(query, sizeof(stat)+sizeof(chunk) , stat, chunk);  mysql_real_query(conn, query, len);  fclose(fp);  mysql_close(conn);}

在本例中，我们把一张图片存储到images表中。图片大小最大不超过1M。

首先我们，打开一个图片文件，并读取图片数据：

 fp = fopen("image.png", "rb");

 size = fread(data, 1, 1024*1000, fp);

二进制数据可以包含一些特殊的字符，这些在sql语句中可能会引起一些问题。所以必须进行转义，理论上来说，每个字符可能是特殊字符。所以chunk数组大小是data数组大小的两倍，该函数会在chunk数组加上结尾符。

 mysql_real_escape_string(conn, chunk, data, size);

一下两行代码拼接insert所用的sql语句：

 char *stat = "INSERT INTO images(id, data) VALUES('1', '%s')";

 len = snprintf(query, sizeof(stat)+sizeof(chunk) , stat, chunk);

最后，执行sql语句：

mysql_real_query(conn, query, len);

（九）从Mysql数据库取回图片

在上一节中，我们把图片保存到数据库中，本节我们把图片从数据库中取回并且还原为图片，本节示例代码如下：

#include <my_global.h>#include <mysql.h>int main(int argc, char **argv){  MYSQL *conn;  MYSQL_RES *result;  MYSQL_ROW row;  unsigned long *lengths;  FILE *fp;  conn = mysql_init(NULL);  mysql_real_connect(conn, "localhost", "zetcode", "passwd", "testdb", 0, NULL, 0);  fp = fopen("image.png", "wb");  mysql_query(conn, "SELECT data FROM images WHERE id=1");  result = mysql_store_result(conn);  row = mysql_fetch_row(result);  lengths = mysql_fetch_lengths(result);  fwrite(row[0], lengths[0], 1, fp);  mysql_free_result(result);  fclose(fp);  mysql_close(conn);}

首先，我们创建一个文件用来保存图片：

fp = fopen("image.png", "wb");

然后，我们把之前的图片查询出来：

 mysql_query(conn, "SELECT data FROM images WHERE id=1");

之后，得到图片数据和数据长度：

row = mysql_fetch_row(result);

lengths = mysql_fetch_lengths(result);

最后，使用fwrite把图片保存到文件中：

fwrite(row[0], lengths[0], 1, fp);