SQlite数据库的C编程接口(二) 数据库连接 ——《Using SQlite》读书笔记
来源:互联网 发布:淘宝买家退款率8% 编辑:程序博客网 时间:2024/05/18 12:29
SQlite数据库的C编程接口(二) 数据库连接 by斜风细雨QQ:253786989 2012-02-03
库初始化
- int sqlite3_initialize(void);
- int sqlite3_shutdown(void);
int sqlite3_initialize(void);int sqlite3_shutdown(void);
在使用SQlite Library之前,首先应该调用sqlite3_initialize函数,该函数将分配资源,初始化一些必要的数据结构。与之配合使用的另一个函数是sqlite3_shutdown,该函数用来释放由sqlite3_initialize分配的资源。不过在很多客户的应用程序中通常直接调用sqlite3_open或者另一些主要的API函数,这些函数会自动初始化SQlite library(如果它还没有被初始化的话)。不过还是推荐客户应用程序显示调用这两个APIs函数来完成SQlite library的初始化和最后的清理工作。
打开数据库
- int sqlite3_open(
- const char *filename, /* Database filename (UTF-8) */
- sqlite3 **ppDb /* OUT: SQLite db handle */
- );
- int sqlite3_open16(
- const void *filename, /* Database filename (UTF-16) */
- sqlite3 **ppDb /* OUT: SQLite db handle */
- );
- int sqlite3_open_v2(
- const char *filename, /* Database filename (UTF-8) */
- sqlite3 **ppDb, /* OUT: SQLite db handle */
- int flags, /* Flags */
- const char *zVfs /* Name of VFS module to use */
- );
int sqlite3_open( const char *filename, /* Database filename (UTF-8) */ sqlite3 **ppDb /* OUT: SQLite db handle */);int sqlite3_open16( const void *filename, /* Database filename (UTF-16) */ sqlite3 **ppDb /* OUT: SQLite db handle */);int sqlite3_open_v2( const char *filename, /* Database filename (UTF-8) */ sqlite3 **ppDb, /* OUT: SQLite db handle */ int flags, /* Flags */ const char *zVfs /* Name of VFS module to use */);
在执行任何SQL语句之前,必须首先连接到一个数据库,也就是打开或者新建一个SQlite3数据库文件。连接数据库由sqlite3_open函数完成,它一共有上面3个版本。其中 sqlite3_open函数假定SQlite3数据库文件名为UTF-8编码,sqlite3_open_v2是它的加强版。sqlite3_open16函数假定SQlite3数据库文件名为UTF-16(Unicode宽字符)编码。
所有这三个函数,参数filename是要连接的SQlite3数据库文件名字符串。参数ppDb看起来有点复杂,它是一个指向指针的指针。当调用sqlite3_open_xxx函数时,该函数将分配一个新的SQlite3数据结构,然后初始化,然后将指针ppDb指向它。所以客户应用程序可以通过sqlite3_open_xxx函数连接到名为filename的数据库,并通过参数ppDb返回指向该数据库数据结构的指针。
示例代码:
- sqlite3 *pDB = NULL;
- Status rc = sqlite3_open("database.sqlite3", &pDB);
sqlite3 *pDB = NULL; Status rc = sqlite3_open("database.sqlite3", &pDB);
对于sqlite3_open和sqlite3_open16函数,如果可能将以可读可写的方式打开数据库,否则以只读的方式打开数据库。如果要打开的数据库文件不存在,就新建一个。对于sqlite3_open_v2函数,情况就要复杂一些了,因为这个v2版本的函数强大就强大在它可以对打开(连接)数据库的方式进行控制,具体是通过它的参数flags来完成。sqlite3_open_v2函数只支持UTF-8编码的SQlite3数据库文件。
如flags设置为SQLITE_OPEN_READONLY,则SQlite3数据库文件以只读的方式打开,如果该数据库文件不存在,则sqlite3_open_v2函数执行失败,返回一个error。如果flags设置为SQLITE_OPEN_READWRITE,则SQlite3数据库文件以可读可写的方式打开,如果该数据库文件本身被操作系统设置为写保护状态,则以只读的方式打开。如果该数据库文件不存在,则sqlite3_open_v2函数执行失败,返回一个error。如果flags设置为SQLITE_OPEN_READWRITE | SQLITE_OPEN_CREATE,则SQlite3数据库文件以可读可写的方式打开,如果该数据库文件不存在则新建一个。这也是sqlite3_open和sqlite3_open16函数的默认行为。除此之外,flags还可以设置为其他标志,具体可以查看SQlite官方文档。
参数zVfs允许客户应用程序命名一个虚拟文件系统(Virtual File System)模块,用来与数据库连接。VFS作为SQlite library和底层存储系统(如某个文件系统)之间的一个抽象层,通常客户应用程序可以简单的给该参数传递一个NULL指针,以使用默认的VFS模块。
对于UTF-8编码的SQlite3数据库文件,推荐使用sqlite3_open_v2函数进行连接,它可以对数据库文件的打开和处理操作进行更多的控制。
SQlite3数据库文件的扩展名没有一个标准定义,比较流行的选择是.sqlite3、.db、.db3。不过在Windows系统平台上,不推荐使用.sdb作为 SQlite3数据库文件的扩展名,据说这会导致IO速度显著减慢,因为.sdb扩展名有其特殊用义。
关闭数据库
- int sqlite3_close(sqlite3 *);
int sqlite3_close(sqlite3 *);
在使用完SQlite数据库之后,需要调用sqlite3_close函数关闭数据库连接,释放数据结构所关联的内存,删除所有的临时数据项。如果在调用sqlite3_close函数关闭数据库之前,还有某些没有完成的(nonfinalized)SQL语句,那么sqlite3_close函数将会返回SQLITE_BUSY错误。客户程序员需要finalize所有的预处理语句(prepared statement)之后再次调用sqlite3_close。
示例代码
- #include "sqlite3.h"
- #include <stdlib.h>
- int main( int argc, char **argv )
- {
- Char *file = "database.sqlite3";
- sqlite3 *pDB = NULL;
- int rc = 0;
- sqlite3_initialize( );
- rc = sqlite3_open_v2( file, &db, SQLITE_OPEN_READWRITE |
- SQLITE_OPEN_CREATE, NULL );
- if ( rc != SQLITE_OK)
- {
- sqlite3_close( db );
- exit( -1 );
- }
- /* perform database operations */
- sqlite3_close( db );
- sqlite3_shutdown( )
- }
#include "sqlite3.h"#include <stdlib.h>int main( int argc, char **argv ){ Char *file = "database.sqlite3"; sqlite3 *pDB = NULL; int rc = 0; sqlite3_initialize( ); rc = sqlite3_open_v2( file, &db, SQLITE_OPEN_READWRITE | SQLITE_OPEN_CREATE, NULL ); if ( rc != SQLITE_OK) {sqlite3_close( db );exit( -1 ); } /* perform database operations */ sqlite3_close( db ); sqlite3_shutdown( )}
SQlite数据库的C编程接口(二) 数据库连接 by斜风细雨QQ:253786989 2012-02-03
- SQlite数据库的C编程接口(二) 数据库连接 ——《Using SQlite》读书笔记
- SQlite数据库的C编程接口(二) 数据库连接 ——《Using SQlite》读书笔记
- SQlite数据库的C编程接口(二) 数据库连接 ——《Using SQlite》读书笔记
- SQlite数据库的C编程接口(一) 简介 ——《Using SQlite》读书笔记
- SQlite数据库的C编程接口(一) 简介 ——《Using SQlite》读书笔记
- SQlite数据库的C编程接口(一) 简介 ——《Using SQlite》读书笔记
- SQlite数据库的C编程接口(七) 数据库锁定(Database Locking) ——《Using SQlite》读书笔记
- SQlite数据库的C编程接口(七) 数据库锁定(Database Locking) ——《Using SQlite》读书笔记
- SQlite数据库的C编程接口(七) 数据库锁定(Database Locking) ——《Using SQlite》读书笔记 .
- SQlite数据库的C编程接口(七) 数据库锁定(Database Locking) ——《Using SQlite》读书笔记
- SQlite数据库的C编程接口(三) 预处理语句(Prepared Statements) ——《Using SQlite》读书笔记 .
- SQlite数据库的C编程接口(四) 绑定参数(Bound Parameters) ——《Using SQlite》读书笔记
- SQlite数据库的C编程接口(五) 便捷函数(Convenience Functions) ——《Using SQlite》读书笔记
- SQlite数据库的C编程接口(八) 工具函数(Utility Functions) ——《Using SQlite》读书笔记
- SQlite数据库的C编程接口(三) 预处理语句(Prepared Statements) ——《Using SQlite》读书笔记 .
- SQlite数据库的C编程接口(四) 绑定参数(Bound Parameters) ——《Using SQlite》读书笔记
- SQlite数据库的C编程接口(五) 便捷函数(Convenience Functions) ——《Using SQlite》读书笔记
- SQlite数据库的C编程接口(八) 工具函数(Utility Functions) ——《Using SQlite》读书笔记
- Matlab中cov函数的算法
- 代码块与静态代码块
- boost::asio 无法接受新连接的处理方法
- 一步一步实现C++操作SQLite数据库
- SQlite数据库的C编程接口(一) 简介 ——《Using SQlite》读书笔记
- SQlite数据库的C编程接口(二) 数据库连接 ——《Using SQlite》读书笔记
- linux 中echo命令的换行方法
- SQlite数据库的C编程接口(三) 预处理语句(Prepared Statements) ——《Using SQlite》读书笔记 .
- java的逻辑运算!
- SQlite数据库的C编程接口(四) 绑定参数(Bound Parameters) ——《Using SQlite》读书笔记
- 使用JAXB处理JAVA和XML
- SQlite数据库的C编程接口(五) 便捷函数(Convenience Functions) ——《Using SQlite》读书笔记
- java中的类
- Flex反射得到属性和属性的值