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=≶
如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); 关闭句柄;
第一个参数是 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;
结果:
先说几个数据结构:
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=≶
如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非常简单,和普通的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++;
}
}
结果: