27.7.16 C API 准备的日期和时间值的语句处理
二进制(准备好的语句)协议使您可以使用MYSQL_TIME
结构发送和接收日期和时间值(DATE,TIME,DATETIME和TIMESTAMP)。 第 27.7.8 节“ C API 准备的语句数据结构”中描述了此结构的成员。
要发送时间数据值,请使用mysql_stmt_prepare()创建准备好的语句。然后,在调用mysql_stmt_execute()执行该语句之前,使用以下过程来设置每个时间参数:
-
在与数据值关联的
MYSQL_BIND
结构中,将buffer_type
成员设置为指示您要发送哪种时间值的类型。对于DATE,TIME,DATETIME或TIMESTAMP值,分别将buffer_type
设置为MYSQL_TYPE_DATE
,MYSQL_TYPE_TIME
,MYSQL_TYPE_DATETIME
或MYSQL_TYPE_TIMESTAMP
。 -
将
MYSQL_BIND
结构的buffer
成员设置为您在其中传递时间值的MYSQL_TIME
结构的地址。 -
填写适用于要传递的时间值类型的
MYSQL_TIME
结构的成员。
使用mysql_stmt_bind_param()将参数数据绑定到语句。然后,您可以致电mysql_stmt_execute()。
要检索时间值,过程与之类似,除了将buffer_type
成员设置为希望接收的值的类型,并将buffer
成员设置为应将返回值放置在MYSQL_TIME
结构的地址上。在调用mysql_stmt_execute()之后和获取结果之前,使用mysql_stmt_bind_result()将缓冲区绑定到该语句。
这是一个插入DATE,TIME和TIMESTAMP数据的简单示例。 mysql
变量被假定为有效的连接处理程序。
MYSQL_TIME ts;
MYSQL_BIND bind[3];
MYSQL_STMT *stmt;
strmov(query, "INSERT INTO test_table(date_field, time_field, \
timestamp_field) VALUES(?,?,?");
stmt = mysql_stmt_init(mysql);
if (!stmt)
{
fprintf(stderr, " mysql_stmt_init(), out of memory\n");
exit(0);
}
if (mysql_stmt_prepare(mysql, query, strlen(query)))
{
fprintf(stderr, "\n mysql_stmt_prepare(), INSERT failed");
fprintf(stderr, "\n %s", mysql_stmt_error(stmt));
exit(0);
}
/* set up input buffers for all 3 parameters */
bind[0].buffer_type= MYSQL_TYPE_DATE;
bind[0].buffer= (char *)&ts;
bind[0].is_null= 0;
bind[0].length= 0;
...
bind[1]= bind[2]= bind[0];
...
mysql_stmt_bind_param(stmt, bind);
/* supply the data to be sent in the ts structure */
ts.year= 2002;
ts.month= 02;
ts.day= 03;
ts.hour= 10;
ts.minute= 45;
ts.second= 20;
mysql_stmt_execute(stmt);
..