本文介绍一下SQLite C/C++接口。
早期的SQLite C/C++接口只有5个接口函数,很容易学习。 新版本的SQLite新增了很多功能,目前大概有185个API接口。本文介绍一些核心的API接口和对象。
1. 核心对象 数据库连接对象: sqlite3 prepared_statement对象: sqlite3_stmt
严格的讲 sqlite3_stmt对象也不是必须的, 另外两个封装了qlite3_stmt的接口sqlite3_exec和sqlite3_get_table可以代替sqlite3_stmt对象完成数据存取工作。 但是理解sqlite3_stmt对于充分使用SQLite有很大帮助。
以下是一些操作 sqlite3和sqlite3_stmt对象的接口。下面这些名字只是提供一个概念,实际的函数可能会有很多版本比如sqlite3_open() 有,sqlite3_open_v16(),sqlite3_open_v2() sqlite3_open() sqlite3_prepare() sqlite3_step() sqlite3_column() sqlite3_finalize() sqlite3_close()
函数说明 sqlite3_open() 打开一个数据库连接,返回sqlite3对象 sqlite3_prepare() 此函数将SQL转换成sqlite3_stmt对象,通常使用sqlite3_prepare_v2() sqlite3_step() 此函数单步执行sqlite3_stmt sqlite3_column() 返回 sqlite3_stmt所在行的指定column的值, 有如下具体函数 * sqlite3_column_blob() * sqlite3_column_bytes() * sqlite3_column_bytes16() * sqlite3_column_count() * sqlite3_column_double() * sqlite3_column_int() * sqlite3_column_int64() * sqlite3_column_text() * sqlite3_column_text16() * sqlite3_column_type() * sqlite3_column_value()
sqlite3_finalize() 销毁 sqlite3_stmt对象,所有sqlite3_stmt对象都应该销毁以防止内存泄漏 sqlite3_close() 关闭数据库连接,销毁sqlite3对象,所有与这个sqlite3对象相关的sqlite3_stmt对象都应该在调用这个函数之前销毁。
2. 绑定和重新执行sqlite3_stmt sqlite3_reset(): 此函数使得执行过sqlite3_step()的sqlite3_stmt重新执行,相当于将游标返回到开始位置重新读取数据,sqlite3_reset()的效率比重新创建一个sqlite3_stmt搞很多。
sqlite3_bind(): 此函数用于INSERT SQL,当同一个INSERT SQL要插入一系列数据时使用,每次sqlite3_step()后重新bind数据。
3. 一般用法和步骤 (1) Create a prepared statement using sqlite3_prepare(). (2) Evaluate the prepared statement by calling sqlite3_step() one or more times. (3) For queries,extract results by calling sqlite3_column() in between two calls to sqlite3_step(). (4) Destroy the prepared statement using sqlite3_finalize().
4. 简易接口 sqlite3_get_table() sqlite3_exec()
5. 例子
view plaincopy to clipboardprint? 01.void basic_interface() 02.{ 03. sqlite3 *db; 04. char *zErrMsg = 0; 05. int rc; 06. char sql[]="select * from addr;"; 07. sqlite3_stmt *stmt; 08. int id; 09. unsigned char *street,*city; 10. rc = sqlite3_open("D:/VCWork/test.db",&db); 11. if( rc ){ 12. fprintf(stderr,"Can't open database: %s/n",sqlite3_errmsg(db)); 13. sqlite3_close(db); 14. return; 15. } 16. rc= sqlite3_prepare_v2(db,sql,strlen(sql),&stmt,0); 17. if( rc ){ 18. fprintf(stderr,"Can't open statement: %s/n",sqlite3_errmsg(db)); 19. sqlite3_close(db); 20. return; 21. } 22. //right align output format 23. printf("%10s %10s %10s/n","id","street","city"); 24. printf("%10s %10s %10s/n","---","---"); 25. while(sqlite3_step(stmt)==SQLITE_ROW ) { 26. id = sqlite3_column_int(stmt,0); 27. street = (unsigned char*)sqlite3_column_text(stmt,1); 28. city = (unsigned char*)sqlite3_column_text(stmt,2); 29. printf("%10d %10s %10s/n",id,street,city); 30. } 31. sqlite3_finalize(stmt); 32. sqlite3_close(db); 33.} void basic_interface() { sqlite3 *db; char *zErrMsg = 0; int rc; char sql[]="select * from addr;"; sqlite3_stmt *stmt; int id; unsigned char *street,*city; rc = sqlite3_open("D:/VCWork/test.db",&db); if( rc ){ fprintf(stderr,sqlite3_errmsg(db)); sqlite3_close(db); return; } rc= sqlite3_prepare_v2(db,0); if( rc ){ fprintf(stderr,sqlite3_errmsg(db)); sqlite3_close(db); return; } //right align output format printf("%10s %10s %10s/n","city"); printf("%10s %10s %10s/n","---"); while(sqlite3_step(stmt)==SQLITE_ROW ) { id = sqlite3_column_int(stmt,0); street = (unsigned char*)sqlite3_column_text(stmt,1); city = (unsigned char*)sqlite3_column_text(stmt,2); printf("%10d %10s %10s/n",city); } sqlite3_finalize(stmt); sqlite3_close(db); }
参考:
An Introduction To The SQLite C/C++ Interface
http://www.sqlite.org/cintro.html (编辑:李大同)
【声明】本站内容均来自网络,其相关言论仅代表作者个人观点,不代表本站立场。若无意侵犯到您的权利,请及时与联系站长删除相关内容!
|