函数:sqlite3_exec(),称为便捷函数,封装了好多任务。
函数声明:
int sqlite3_exec( sqlite * , const char * sql , sqlite_callback , void *data , char ** errmmsg) ; 其中 sqlite* 表示打开的数据库;
sql 为执行的sql语句;
callback回调函数;
void *data为回调函数的第一个参数指向提供给回调函数的应用程序特定的数据,也是回调函数的第一个参数; errmsg 为错误信息,是指向错误消息字符串的指针 。
sqlite_exec() 有两个错误消息来源,返回值和可读的字符串errmsg。
注意:如果提供 了errmsg,用来创建错误消息的内存是在堆上分布的。 故在调用后,应该检查一下是否为null值,如果有错误发生,使用sqlite3_free()释放errmsg占用的内存。
在简单命令中使用sqlite3_ exec( ),实例代码:
int main( int argc , char ** argv )
{
sqlite3 *db;
char *zErr ;
nt rc ;
char *sql;
rc = sqlite3_open_v2( "test.db" , &db);
if( rc) {
fprintf(stderr , " Can't open database :%s\n" , sqlite3_errmsg(db));
sqlite3_close(db);
exit(1);
}
sql="create table episodes(id int , name text ) ";
rc = sqlite3_exec(db , sql, NULL , NULL , &zErr ) ;
if(rc ! = SQLITE_OK) {
if( zErr != NULL ) {
fprintf( stderr , " SQL error : %s\n " , zErr);
sqlite3_free(zErr) ;
}
}
sql = "insert into episodes values ( 10,'the dinner party ' )";
rc = sqlite3_exec(db , sql , NULL ,NULL , &zErr);
sqlite3_close(db) ;
return 0 ;
}
回调函数的声明:
typedef int ( * sqlite3_callback ) (void * , int , char ** ,char ** );其中void *是为sqlite3_exec()第四个参数提供的数据,int代表字段的数目,char** 便是行中字段名称的字符串的数组,char**表示字段ing成的字符串数组。
sqlite3_exec( )允许执行一批命令,并可以通过回调接口收集所有的返回数据。