C 链接mysql---预处理语句

C 链接 mysql的预处理语句

先说几个数据结构：

MYSQL_STMT
该数据结构表示预处理语句。由mysql_stmt_init()创建语句

MYSQL_BIND  -这个数据结构非常重要。
用来绑定语句的参数。可以做输出，也可以做输入。
当使用SQL语句时，里面很有可能存在变量，这时变量就用MYSQL_BIND结构体绑定。
如：insert into test (flag,type,f_index) values (1,?,?) 这样的语句，后两个参数会根据数据不同而发生变化。
则后两个参数就用MYSQL_BIND来存储，用mysql_stmt_bind_param()函数来绑定。

MYSQL_BIND数据结构的成员变量有：
{
 enum enum_field_types buffer_type； 
 void *buffer ；
 unsigned long buffer_length； 
 unsigned long *length ；
 
 my_bool *is_null ；
 my_bool is_unsigned； 
 my_bool error ；
}；

buffer_type：
 缓冲的类型。（见图1）；
 对于输入，buffer_type指明了与语句参数捆绑的值类型。
 对于输出，它指明了你希望从结果缓冲收到的值类型。
 
buffer：
参数的地址指针，
buffer_length：
缓冲区的长度；
length：
缓冲区中数据的长度的地址；这个地方是一个地址，指向的是存储上面buffer中数据实际长度的变量的地址
如：上面buffer中存储的数据为arr[1024]中的数据，unsigned long lg=strlen(arr),则length=&lg；
如char arr[1024]="abcd";则缓冲区的长度为sizeof(arr)=1024，数据的长度为strlen(arr)=4；

下面的三个参数解释来自于mysql操作手册
my_bool *is_null 
该成员指向my_bool变量，如果值为NULL，该变量为“真”，如果值为非Null，该变量为“假”。对于输入，将*is_null设置为“真”，
指明以语句参数的形式传递NULL值。对于输出，如果从语句返回的结果集列值为NULL，当获取了行后，该值将被设为“真”。
“is_null”是指向布尔类型的指针，而不是布尔标量，以便能以下述方式使用它：
如果数据值总是NULL，使用MYSQL_TYPE_NULL绑定列。
如果数据值总是NOT NULL，设置is_null = (my_bool*) 0。
在所有其他情况下，应将is_null设置为my_bool变量的地址，并在各次执行之间恰当地更改变量的值，以指明数据值是NULL或NOT NULL。

my_bool is_unsigned 
该成员用于整数类型。（对应于MYSQL_TYPE_TINY、MYSQL_TYPE_SHORT、MYSQL_TYPE_LONG、以及MYSQL_TYPE_LONGLONG类型的代码）。
对于无符号类型，应将“is_unsigned”设置为“真”，对于带符号类型，应将其设置为“假”。

my_bool error 
对于输出，该成员用于通报数据截短错误。必须通过调用带有MYSQL_REPORT_DATA_TRUNCATION选项的mysql_options()，
启用截短通报功能。允许该功能后，mysql_stmt_fetch()返回MYSQL_DATA_TRUNCATED，而且对于出现截短情况的参数，
在MYSQL_BIND结构中，错误标志为“真”。截短指明丢失了符号或有效位数，或字符串过长以至于无法容纳在1列中。

要想使用MYSQL_BIND结构，应将其内容置为0以便初始化它，然后对其进行设置，恰当地描述它。例如，要想声明并初始化三个MYSQL_BIND结构的数组，可使用下述代码：
MYSQL_BIND    bind[3];
memset(bind, 0, sizeof(bind));

每一个MYSQL_BIND结构体只能存储一个参数，所以用结构体数组来表示多个参数。


API：
1、MYSQL_STMT *mysql_stmt_init(MYSQL *mysql) 
描述：创建句柄，
参数是连接成功后的 mysql 实例；
返回值：成功返回预处理句柄，失败返回NULL；
可以用 mysql_stmt_close(MYSQL_STMT *ms); 关闭句柄；

2.int mysql_stmt_prepare(MYSQL_STMT *stmt, const char *query, unsigned long length) 

描述:准备将要执行的sql语句，如果sql中有变量，用 ？代替；
第一个参数是 mysql_stmt_init()返回的句柄。
第二个参数是 要执行的sql语句；
第三个参数是 SQL语句的实际长度；
返回值：
成功返回0，失败返回非0；


3.my_bool mysql_stmt_bind_param(MYSQL_STMT *stmt, MYSQL_BIND *bind) 
描述：绑定参数到预处理句柄；
第一个参数是预处理句柄；
第二个参数是准备的MYSQL_BIND 数据结构的地址；
返回值：
成功返回0；失败返回非0；

4.int mysql_stmt_execute(MYSQL_STMT *stmt) 
描述：
执行预处理语句；
在此函数执行之前一定要绑定好参数；
返回值：
成功返回0；失败返回非0；

图一：

由上面这几个API便可以写一个简单的演示代码：

如果想了解更多关于预处理的API 下载资料，其他的几个API非常简单，和普通的C链接mysql的API相似；

#include <stdio.h>
#include <stdlib.h>
#include <mysql/mysql.h>
#include <string.h>
#define INSERT_SQL "insert into test (flag,type,f_index) values (1,?,?)"


MYSQL mysql;
MYSQL_BIND bind[2];
unsigned long length[2];
typedef struct Data
{
		char ty_buf[20];
		int f_index;
}dt;

void err(char *p)
{
		perror(p);
		exit(-1);
}

int main()
{
		memset(bind,0,sizeof(bind));
		dt in_dt;
		mysql_init(&mysql);
		mysql_real_connect(&mysql,"12.23.0.3","sum","sum","test",3306,NULL,0);
		MYSQL_STMT *insert=mysql_stmt_init(&mysql);
		if( insert == NULL) err("mysql_stmt_init");
		if(mysql_stmt_prepare(insert,INSERT_SQL,strlen(INSERT_SQL))) err("mysql_stmt_prepare");
		
		
		bind[0].buffer_type=MYSQL_TYPE_STRING;
		bind[0].buffer=(char*)in_dt.ty_buf;
		bind[0].buffer_length=sizeof(in_dt.ty_buf);
		bind[0].length=&length[0];

		bind[1].buffer_type=MYSQL_TYPE_LONG;
		bind[1].buffer=(int *)&in_dt.f_index;
		bind[1].buffer_length=sizeof(in_dt.f_index);
		bind[1].length=&length[1];
		
		if(mysql_stmt_bind_param(insert,bind)) err("mysql_stmt_bind_param");
		int i=0;
		while(i<1000)
		{
			sprintf(in_dt.ty_buf,"test_%d",i);
			in_dt.f_index=i;
		
			length[0]=strlen(in_dt.ty_buf);
			length[1]=sizeof(in_dt.f_index);
			if(mysql_stmt_execute(insert)) err("mysql_stmt_execute");
			i++;
		}
}

结果：