mysql提供给c语言的api 和c语言连接mysql例子程序

首先粘出来两个重要的结构体组成，不需要知道每个字段，只需要知道文中提到的东西就ok了

typedef struct st_mysql {
 NET           net;            /* Communication parameters */
 gptr          connector_fd;   /* ConnectorFd for SSL */
 char          *host,*user,*passwd,*unix_socket,
                *server_version,*host_info,*info,*db;
 unsigned int port,client_flag,server_capabilities;
 unsigned int protocol_version;
 unsigned int field_count;
 unsigned int server_status;
 unsigned long thread_id;      /* Id for connection in server */
 my_ulonglong affected_rows;
 my_ulonglong insert_id;       /* id if insert on table with NEXTNR */
 my_ulonglong extra_info;              /* Used by mysqlshow */
 unsigned long packet_length;
 enum mysql_status status;
 MYSQL_FIELD   *fields;
 MEM_ROOT      field_alloc;
 my_bool       free_me;        /* If free in mysql_close */
 my_bool       reconnect;      /* set to 1 if automatic reconnect */
 struct st_mysql_options options;
 char          scramble_buff[9];
 struct charset_info_st *charset;
 unsigned int server_language;
} MYSQL;

这个结构代表返回行的一个查询的(SELECT, SHOW, DESCRIBE, EXPLAIN)的结果。返回的数据称为“数据集”，用过数据库的朋友应该对数据库中查询后得到的结果集不会陌生，在C的API里对应的就是MYSQL_RES了，从数据库读取数据，最后就是从MYSQL_RES中读取数据。


typedef struct st_mysql_res {
 my_ulonglong row_count;
 unsigned int field_count, current_field;
 MYSQL_FIELD   *fields;
 MYSQL_DATA    *data;
 MYSQL_ROWS    *data_cursor;
 MEM_ROOT      field_alloc;
 MYSQL_ROW     row;            /* If unbuffered read */
 MYSQL_ROW     current_row;    /* buffer to current row */
 unsigned long *lengths;       /* column lengths of current row */
 MYSQL         *handle;        /* for unbuffered reads */
 my_bool       eof;            /* Used my mysql_fetch_row */
} MYSQL_RES;

 

具体可以参考mysql官方网站：
http://dev.mysql.com/doc/refman/5.1/en/c.html

c语言连接mysql的具体过程如下（STATEMENT: 此处是将实际开发过程每个步骤需要了解的过程，至于协议和结构体组成请自行参看mysql提供的api文档）：

1.首先当然是连接，函数原型如下：

MYSQL *		STDCALL 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是 C api中一个非常重要的变量，里面内存非常丰富，有port,dbname,charset等连接基本参数。它也包含了一个叫st_mysql_methods的结构体变量，该变量里面保存着很多函数指针，这些函数指针将会在数据库连接成功以后的各种数据操作中被调用。
mysql_real_connect函数中各参数，基本都是顾名思意。

连接成功以后就需要执行sql语句。

函数如下原型如下：

 

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

第一个参数上面已经介绍过，第二个参数为要执行的sql语句。
这个函数总体就两步
（1）.发送sql语句，其实就一个socket发送sql 语句，加上mysql固定的协议头。懒的去看源码了，抓了下包，如下：
0000   19 00 00 00 03 73 65 6c 65 63 74 20 61 70 70 5f  .....select app_
0010   6e 61 6d 65 20 66 72 6f 6d 20 61 70 70           name from app

红色部分是协议，前面两位其实就是包的长度。具体协议没研究过。

（2）.然后就是接受结果，这里将会调用MYSQL变量中的st_mysql_methods中的read_query_result函数指针

获取结果
sql执行完以后，如果是查询语句，我们当然还要读取数据，如果update，insert等语句，那么就看下操作成功与否即可。
我们来看看如何获取查询结果：

如果mysql_query返回成功，那么我们就通过mysql_store_result这个函数来读取结果。原型如下：

 MYSQL_RES * STDCALL mysql_store_result(MYSQL *mysql)

该函数会调用MYSQL变量中的st_mysql_methods中的read_rows函数指针来获取查询的结果。同时该函数会返回MYSQL_RES 这样一个变量，该变量主要用于保存查询的结果。同时该函数malloc了一片内存空间来存储查询过来的数据，所以我们一定要记的free(result),不然是肯定会造成内存泄漏的。

执行完mysql_store_result以后，其实数据都已经在MYSQL_RES 变量中了，下面的api基本就是读取MYSQL_RES 中的数据。

例如mysql_fetch_row这个函数，就是读去查询结果的一行。函数原型如下

C代码

1. MYSQL_ROW   STDCALL mysql_fetch_row(MYSQL_RES *result); 

MYSQL_ROW	STDCALL mysql_fetch_row(MYSQL_RES *result);

它会返回一个MYSQL_ROW变量，MYSQL_ROW其实就是char **.就当成一个二维数组来用吧。

例如：

C代码

1. sql_row=mysql_fetch_row(result) 
2. printf("%s\n",sql_row[0]); 

sql_row=mysql_fetch_row(result)
printf("%s\n",sql_row[0]);

还有很多api，不再一一介绍，大部分信息都在MYSQL_RES MYSQL这两个结构体中。
官方网站资料非常全面，貌似比任何书都要好。

下面来个例子吧。

#include<stdio.h>
#include<stdlib.h>
#include<string.h>
#include<mysql/mysql.h>
#define MAX_COLUMN_LEN	32
int main(int argc , char *argv[])
{
	MYSQL my_connection;
	MYSQL_RES *result;
	MYSQL_ROW sql_row;
	MYSQL_FIELD *fd;
	char column[MAX_COLUMN_LEN][MAX_COLUMN_LEN];
	int res;
	mysql_init(&my_connection);
	if(mysql_real_connect(&my_connection,"127.0.0.1"
							,"用户","密码","数据名称",3306,NULL,0))
	{
		perror("connect");
		res=mysql_query(&my_connection,"select * from app");//查询
		if(!res)
		{
			result=mysql_store_result(&my_connection);//保存查询到的数据到result
			if(result)
			{
				int i,j;
				printf("the result number is %lu\n ",(unsigned long)mysql_num_rows(result));
				for(i=0;fd=mysql_fetch_field(result);i++)//获取列名
				{
					bzero(column[i],sizeof(column[i]));
					strcpy(column[i],fd->name);
				}
				j=mysql_num_fields(result);
				for(i=0;i<j;i++)
				{
					printf("%s\t",column[i]);
				}
				printf("\n");
				while(sql_row=mysql_fetch_row(result))//获取具体的数据
				{
					for(i=0;i<j;i++)
					{
						printf("%s\t",sql_row[i]);
					}
					printf("\n");
				}
				
			}
		}
		else
		{
			perror("select");
		}
	}
	else
	{
		perror("connect:error");
	}
	mysql_free_result(MYSQL_RES *result);//释放结果资源
	mysql_close(&my_connection);//断开连接

}

上面这个例子就是从一个表中查数据，然后输出。

如果要insert或者update，只需要修改具体的sql既可。
具体的操作都是通过mysql_query这个函数来搞定。

现在来讲编译的方法吧，这里我们需要.h以及.so库。
我们可以在
http://dev.mysql.com/downloads/connector/c/6.0.html
下载Connector/C。
简单的方法就是：
把里面include的东西拷贝到/usr/include/mysql/下面去，这样编译的时候就不需要加-I了，然后把lib下面的东西拷贝的/usr/lib/下去。

gcc具体的编译方法：gcc ***.c -o *** -lmysqlclient