SQLite3使用总结(转载)
SQLite3的确很好用。小巧、速度快。这些天正在研究它,将它移植到ARM系统里面,又有一些收获,这里把我对sqlite3的研究列出来,以备忘记。【其中有摘抄自互联网】
SQLite3提供的是一些C函数接口,你可以用这些函数操作数据库。通过使用这些接口,传递一些标准sql语句(以char *类型)给SQLite3函数,SQLite3就会为你操作数据库。 SQLite3跟MS的access一样是文件型数据库,就是说,一个数据库就是一个文件,此数据库里可以建立很多的表,可以建立索引、触发器等等,但是,它实际上得到的就是一个文件。备份这个文件就备份了整个数据库。 SQLite3不需要任何数据库引擎,这意味着如果你需要SQLite3来保存一些用户数据,甚至都不需要安装数据库。 打开数据库 int sqlite3_open(const char *zFilename,sqlite3 **ppDb) 需要传入两个参数,一是数据库文件名,比如:"/flash/mydb1.db"。文件名不需要一定存在,如果此文件不存在,SQLite3会自动建立它。如果它存在,就尝试把它当数据库文件来打开。sqlite3 **ppDb参数是关键数据结构。这个结构底层细节如何,你不要关它。 函数返回值表示操作是否正确,如果是SQLITE_OK则表示操作正常。相关的返回值sqlite定义了一些宏。具体这些宏的含义可以参考sqlite3.h文件。里面有详细定义(顺便说一下,SQLite3的代码注释率自称是非常高的,实际上也的确很高。只要你会看英文,SQLite3可以让你学到不少东西)。 关闭数据库 int sqlite3_close(sqlite3 *db) 如果用sqlite3_open开启了一个数据库,结尾时不要忘了用这个函数关闭数据库。 使用例题: { sqlite3 *db; int res; res = sqlite3_open("/flash/db1.db",&db); if(res != SQLITE_OK) { return -1; } sqlite3_close(db); } 执行sql语句 int sqlite3_exec(sqlite3 *db,const char *zSql,sqlite3_callback xCallback,void *pArg,char **pzErrMsg) 这就是执行一条sql语句的函数。 第1个参数不再说了,是前面open函数得到的指针。说了是关键数据结构。 第2个参数const char *sql是一条sql语句,以/0结尾。 第3个参数sqlite3_callback是回调,当这条语句执行之后,sqlite3会去调用你提供的这个函数。 第4个参数void *pArg是你所提供的指针,你可以传递任何一个指针参数到这里,这个参数最终会传到回调函数里面,如果不需要传递指针给回调函数,可以填NULL。等下我们再看回调函数的写法,以及这个参数的使用。 第5个参数char ** errmsg是错误信息。注意是指针的指针。sqlite3里面有很多固定的错误信息。执行sqlite3_exec之后,执行失败时可以查阅这个指针(直接printf(“%s/n”,errmsg))得到一串字符串信息,这串信息告诉你错在什么地方。sqlite3_exec函数通过修改你传入的指针的指针,把你提供的指针指向错误提示信息,这样sqlite3_exec函数外面就可以通过这个char*得到具体错误提示。 说明:通常,sqlite3_callback和它后面的void *这两个位置都可以填NULL。填NULL表示你不需要回调。比如你做insert操作,做delete操作,就没有必要使用回调。而当你做select时,就要使用回调,因为sqlite3把数据查出来,得通过回调告诉你查出了什么数据。 exec的回调 typedef int(*sqlite3_callback)(void *,int,char**,char**); 你的回调函数必须定义成上面这个函数的类型。下面给个简单的例子: //sqlite3的回调函数 int main( int,char ** ) result = sqlite3_open("/flash/db1.db",&db); result = sqlite3_exec( db,“create table MyTable_1( ID integer primary key autoincrement,name nvarchar(32) )”,NULL,errmsg ); //插入一些记录 result = sqlite3_exec( db,“insert into MyTable_1( name ) values (‘走路’)”,errmsg ); result = sqlite3_exec( db,“insert into MyTable_1( name ) values (‘骑单车’)”,“insert into MyTable_1( name ) values (‘坐汽车’)”,errmsg ); //开始查询数据库 result = sqlite3_exec( db,“select * from MyTable_1”,LoadMyInfo,errmsg ); //关闭数据库 sqlite3_close( db ); return0; } 通过上面的例子,应该可以知道如何打开一个数据库,如何做数据库基本操作。有这些知识,基本上可以应付很多数据库操作了。 不使用回调查询数据库 上面介绍的sqlite3_exec是使用回调来执行select操作。还有一个方法可以直接查询而不需要回调。但是,我个人感觉还是回调好,因为代码可以更加整齐,只不过用回调很麻烦,你得声明一个函数,如果这个函数是类成员函数,你还不得不把它声明成static的(要问为什么?这又是C++基础了。 C++成员函数实际上隐藏了一个参数:this,C++调用类的成员函数的时候,隐含把类指针当成函数的第一个参数传递进去。结果,这造成跟前面说的 sqlite回调函数的参数不相符。只有当把成员函数声明成static时,它才没有多余的隐含的this参数)。 虽然回调显得代码整齐,但有时候你还是想要非回调的select查询。这可以通过sqlite3_get_table函数做到。 intsqlite3_get_table(sqlite3*,constchar*sql,char***resultp,int*nrow,int*ncolumn,char**errmsg ); 第1个参数不再多说,看前面的例子。 第2个参数是sql语句,跟sqlite3_exec里的sql是一样的。是一个很普通的以/0结尾的char *字符串。 第3个参数是查询结果,它依然一维数组(不要以为是二维数组,更不要以为是三维数组)。它内存布局是:第一行是字段名称,后面是紧接着是每个字段的值。下面用例子来说事。 第4个参数是查询出多少条记录(即查出多少行)。 第5个参数是多少个字段(多少列)。 第6个参数是错误信息,跟前面一样,这里不多说了。 下面给个简单例子: int main( int,char ** ) { sqlite3 * db; int result; char * errmsg = NULL; char **dbResult;//是char **类型,两个*号 int nRow,nColumn; int i,j; int index;
result = sqlite3_open(/flash/db1.db",&db); //数据库操作代码 //假设前面已经创建了MyTable_1表 //开始查询,传入的dbResult已经是char **,这里又加了一个&取地址符,传递进去的就成了char *** result = sqlite3_get_table( db,&dbResult,&nRow,&nColumn,&errmsg ); if(SQLITE_OK== result ) { //查询成功 index = nColumn;//前面说过dbResult前面第一行数据是字段名称,从nColumn索引开始才是真正的数据 printf(“查到%d条记录/n”,nRow ); for( i = 0; i < nRow ; i++ ) { printf(“第%d条记录/n”,i+1 ); for( j = 0 ; j < nColumn; j++ ) { printf(“字段名:%s ?>字段值:%s/n”,dbResult[j],dbResult [index] ); ++index;// dbResult的字段值是连续的,从第0索引到第nColumn - 1索引都是字段名称,从第nColumn索引开始,后面都是字段值,它把一个二维的表(传统的行列表示法)用一个扁平的形式来表示 } printf(“-------/n”); } } //到这里,不论数据库查询是否成功,都释放char**查询结果,使用sqlite提供的功能来释放 sqlite3_free_table( dbResult ); //关闭数据库 sqlite3_close( db ); return0; }
到这个例子为止,sqlite3的常用用法都介绍完了。 用以上的方法,再配上sql语句,完全可以应付绝大多数数据库需求. (编辑:李大同) 【声明】本站内容均来自网络,其相关言论仅代表作者个人观点,不代表本站立场。若无意侵犯到您的权利,请及时与联系站长删除相关内容! |