sqlite3用法详解
|
使用的过程根据使用的函数大致分为如下几个过程： sqlite3_open() sqlite3_prepare() sqlite3_step() sqlite3_column() sqlite3_finalize() sqlite3_close()
这几个过程是概念上的说法，而不完全是程序运行的过程，如sqlite3_column()表示的是对查询获得一行里面的数据的列的各个操作统称，实际上在sqlite中并不存在这个函数。 1． sqlite3_open()：打开数据库 在操作数据库之前，首先要打开数据库。这个函数打开一个sqlite数据库文件的连接并且返回一个数据库连接对象。这个操作同时程序中的第一个调用的sqlite函数，同时也是其他sqlite api的先决条件。许多的sqlite接口函数都需要一个数据库连接对象的指针作为它们的第一个参数。 函数定义 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 */
);
说明： 假如这个要被打开的数据文件不存在，则一个同名的数据库文件将被创建。如果使用sqlite3_open和sqlite3_open_v2的话，数据库将采用UTF-8的编码方式，sqlite3_open16采用UTF-16的编码方式 返回值： 如果sqlite数据库被成功打开（或创建），将会返回SQLITE_OK，否则将会返回错误码。Sqlite3_errmsg()或者sqlite3_errmsg16可以用于获得数据库打开错误码的英文描述，这两个函数定义为： const char sqlite3_errmsg(sqlite3); const void sqlite3_errmsg16(sqlite3); 无论是否成功打开数据库,都应该使用 sqlite3_close() 关闭数据库连接. 参数说明： filename：需要被打开的数据库文件的文件名，在sqlite3_open和sqlite3_open_v2中这个参数采用UTF-8编码，而在sqlite3_open16中则采用UTF-16编码 ppDb：一个数据库连接句柄被返回到这个参数，即使发生错误。唯一的一场是如果sqlite不能分配内存来存放sqlite对象，ppDb将会被返回一个NULL值。 flags：作为数据库连接的额外控制的参数，可以是SQLITE_OPEN_READONLY，SQLITE_OPEN_READWRITE和SQLITE_OPEN_READWRITE|SQLITE_OPEN_CREATE中的一个，用于控制数据库的打开方式，可以和SQLITE_OPEN_NOMUTEX，SQLITE_OPEN_FULLMUTEX， SQLITE_OPEN_SHAREDCACHE，以及SQLITE_OPEN_PRIVATECACHE结合使用，具体的详细情况可以查阅文档 ===================================================================================== 2． Sqlite3_prepare() 这个函数将sql文本转换成一个准备语句（prepared statement）对象，同时返回这个对象的指针。这个接口需要一个数据库连接指针以及一个要准备的包含SQL语句的文本。它实际上并不执行（evaluate）这个SQL语句，它仅仅为执行准备这个sql语句 函数定义（仅列出UTF-8的） int sqlite3_prepare(
sqlite3 *db,/* Database handle */ /* 成功打开的数据库句柄 */
const char *zSql,/* SQL statement,UTF-8 encoded */ /* UTF8编码的 SQL 语句 */
int nByte,/* Maximum length of zSql in bytes. */ /* 参数 sql 的字节数,包含 ' ' */
sqlite3_stmt **ppStmt,/* OUT: Statement handle */ /* 输出:预编译语句句柄 */
const char **pzTail /* OUT: Pointer to unused portion of zSql */ /* 输出:指向 sql 语句中未使用的部分 */
);
int sqlite3_prepare_v2(
sqlite3 *db,/* Database handle */
const char *zSql,UTF-8 encoded */
int nByte,/* Maximum length of zSql in bytes. */
sqlite3_stmt **ppStmt,/* OUT: Statement handle */
const char **pzTail /* OUT: Pointer to unused portion of zSql */
);
参数： db：数据指针 zSql：sql语句，使用UTF-8编码 nByte：如果nByte小于0，则函数取出zSql中从开始到第一个0终止符的内容；如果nByte不是负的，那么它就是这个函数能从zSql中读取的字节数的最大值。如果nBytes非负，zSql在第一次遇见’/000/或’u000’的时候终止.如果用户知道被传入的 sql 语句是以 ‘ ’ 结尾的,那么有一个更好的做法是:把nbytes的值设为该字符串的长度(包含’ ’),这样可以避免 SQLite 复制该字符串的一份拷贝,以提高程序的效率. pzTail：上面提到zSql在遇见终止符或者是达到设定的nByte之后结束，假如zSql还有剩余的内容，那么这些剩余的内容被存放到pZTail中，不包括终止符。如果 pszTail 不为 NULL,则 *pszTail 指向 sql 中第一个被传入的 SQL 语句的结尾. 该函数只编译 sql 的第一个语句,所以 *pszTail 指向的内容则是未被编译的. ppStmt：能够使用sqlite3_step()执行的编译好的准备语句的指针，如果错误发生，它被置为NULL，如假如输入的文本不包括sql语句。调用过程必须负责在编译好的sql语句完成使用后使用sqlite3_finalize()删除它。 说明 如果执行成功，则返回SQLITE_OK，否则返回一个错误码。推荐在现在任何的程序中都使用sqlite3_prepare_v2这个函数，sqlite3_prepare只是用于前向兼容 备注 <1>准备语句（prepared statement）对象 typedef struct sqlite3_stmt sqlite3_stmt; 准备语句（prepared statement）对象一个代表一个简单SQL语句对象的实例，这个对象通常被称为“准备语句”或者“编译好的SQL语句”或者就直接称为“语句”。 语句对象的生命周期经历这样的过程： l 使用sqlite3_prepare_v2或相关的函数创建这个对象 l 使用sqlite3_bind_*()给宿主参数（host parameters）绑定值 l 通过调用sqlite3_step一次或多次来执行这个sql l 使用sqlite3——reset()重置这个语句，然后回到第2步，这个过程做0次或多次 l 使用sqlite3_finalize()销毁这个对象 在sqlite中并没有定义sqlite3_stmt这个结构的具体内容，它只是一个抽象类型，在使用过程中一般以它的指针进行操作，而sqlite3_stmt类型的指针在实际上是一个指向Vdbe的结构体得指针 <2>宿主参数(host parameters) 在传给sqlite3_prepare_v2()的sql的语句文本或者它的变量中，满足如下模板的文字将被替换成一个参数： l ? l ?NNN，NNN代表数字 l :VVV，VVV代表字符 l @VVV l $VVV 在上面这些模板中，NNN代表一个数字，VVV代表一个字母数字标记符（例如:222表示名称为222的标记符），sql语句中的参数（变量）通过上面的几个模板来指定，如 “select ? from ? “这个语句中指定了两个参数，sqlite语句中的第一个参数的索引值是1，这就知道这个语句中的两个参数的索引分别为1和2，使用”?”的话会被自动给予索引值，而使用”?NNN”则可以自己指定参数的索引值，它表示这个参数的索引值为NNN。”:VVV”表示一个名为”VVV”的参数，它也有一个索引值，被自动指定。 例子： INSERT INTO people (id,name) VALUES ( ?,? ); INSERT INTO people (id,id2,name) VALUES ( ?1,?1.?2 );作用：可以用同一个值绑定几个变量 INSERT INTO people (id,name) VALUES ( :id,:name ); INSERT INTO people (id,name) VALUES ( @id,@name ); INSERT INTO people (id,name) VALUES (
可以使用sqlite3_bind_*()来给这些参数绑定值 ===================================================================================== 3. int sqlite3_bind_text(sqlite3_stmt*,int,const char*,int n,void()(void)); sqlite3_bind_*系列函数有好多，这里只对sqlite3_bind_text进行一下说明，sqlite3_bind_text的第二个参数为序号（从1开始），第三个参数为字符串值，第四个参数为字符串长度。sqlite3_bind_text的第五个参数为一个函数指针，SQLITE3执行完操作后回调此函数，通常用于释放字符串占用的内存。此参数有两个常数，SQLITE_STATIC告诉sqlite3_bind_text函数字符串为常量，可以放心使用；而SQLITE_TRANSIENT会使得sqlite3_bind_text函数对字符串做一份拷贝。一般使用这两个常量参数来调sqlite3_bind_text。statement准备好了以后，就是操作的执行了。 int sqlite3_bind_blob(sqlite3_stmt*,const void*,void()(void)); =====================================================================================
这个过程用于执行有前面sqlite3_prepare创建的准备语句。这个语句执行到结果的第一行可用的位置。继续前进到结果的第二行的话，只需再次调用sqlite3_setp()。继续调用sqlite3_setp()知道这个语句完成，那些不返回结果的语句（如：INSERT，UPDATE，或DELETE），sqlite3_step()只执行一次就返回 函数定义 int sqlite3_step(sqlite3_stmt*);
返回值 函数的返回值基于创建sqlite3_stmt参数所使用的函数，假如是使用老版本的接口sqlite3_prepare()和sqlite3_prepare16()，返回值会是 SQLITE_BUSY， SQLITE_DONE， SQLITE_ROW， SQLITE_ERROR 或 SQLITE_MISUSE，而v2版本的接口sqlite3_prepare_v2()和sqlite3_prepare16_v2()则会同时返回这些结果码和扩展结果码。 对所有V3.6.23.1以及其前面的所有版本，需要在sqlite3_step()之后调用sqlite3_reset()，在后续的sqlite3_ step之前。如果调用sqlite3_reset重置准备语句失败，将会导致sqlite3_ step返回SQLITE_MISUSE，但是在V3. 6.23.1以后，sqlite3_step()将会自动调用sqlite3_reset。 说明: ===================================================================================== 5.int sqlite3_reset(sqlite3_stmt *pStmt); int sqlite3_reset(sqlite3_stmt *pStmt);
sqlite3_reset用于重置一个准备语句对象到它的初始状态，然后准备被重新执行。所有sql语句变量使用sqlite3_bind*绑定值，使用sqlite3_clear_bindings重设这些绑定。Sqlite3_reset接口重置准备语句到它代码开始的时候。sqlite3_reset并不改变在准备语句上的任何绑定值，那么这里猜测，可能是语句在被执行的过程中发生了其他的改变，然后这个语句将它重置到绑定值的时候的那个状态。 它的返回值相对有些特殊。返回SQLITE_BUSY表示暂时无法执行操作，SQLITE_DONE表示操作执行完毕，SQLITE_ROW表示执行完毕并且有返回（执行select语句时）。当返回值为SQLITE_ROW时，我们需要对查询结果进行处理，SQLITE3提供sqlite3_column_*系列函数。 =====================================================================================
sqlite3_column()
这个过程从执行sqlite3_step()执行一个准备语句得到的结果集的当前行中返回一个列。每次sqlite3_step得到一个结果集的列停下后，这个过程就可以被多次调用去查询这个行的各列的值。对列操作是有多个函数，均以sqlite3_column为前缀 const void sqlite3_column_blob(sqlite3_stmt,int iCol); int sqlite3_column_bytes(sqlite3_stmt*,int iCol); int sqlite3_column_bytes16(sqlite3_stmt*,int iCol); double sqlite3_column_double(sqlite3_stmt*,int iCol); int sqlite3_column_int(sqlite3_stmt*,int iCol); sqlite3_int64 sqlite3_column_int64(sqlite3_stmt*,int iCol); const unsigned char sqlite3_column_text(sqlite3_stmt,int iCol); const void sqlite3_column_text16(sqlite3_stmt,int iCol); int sqlite3_column_type(sqlite3_stmt*,int iCol); int sqlite3_column_numeric_type(sqlite3_stmt*,int iCol); sqlite3_value sqlite3_column_value(sqlite3_stmt,int iCol); 说明 第一个参数为从sqlite3_prepare返回来的prepared statement对象的指针，第二参数指定这一行中的想要被返回的列的索引。最左边的一列的索引号是0，行的列数可以使用sqlite3_colum_count()获得。 这些过程会根据情况去转换数值的类型，sqlite内部使用sqlite3_snprintf()去自动进行这个转换，下面是关于转换的细节表： 内部类型 请求的类型 转换 NULL INTEGER 结果是0 NULL FLOAT 结果是0.0 NULL TEXT 结果是NULL NULL BLOB 结果是NULL INTEGER FLOAT 从整形转换到浮点型 INTEGER TEXT 整形的ASCII码显示 INTEGER BLOB 同上 FLOAT INTEGER 浮点型转换到整形 FLOAT TEXT 浮点型的ASCII显示 FLOAT BLOB 同上 TEXT INTEGER 使用atoi() TEXT FLOAT 使用atof() TEXT BLOB 没有转换 BLOB INTEGER 先到TEXT，然后使用atoi BLOB FLOAT 先到TEXT，然后使用atof BLOB TEXT 如果需要的话添加0终止符 注：BLOB数据类型是指二进制的数据块，比如要在数据库中存放一张图片，这张图片就会以二进制形式存放，在sqlite中对应的数据类型就是BLOB int sqlite3_column_bytes(sqlite3_stmt*,int iCol)
int sqlite3_column_bytes16(sqlite3_stmt*,int iCol)
两个函数返回对应列的内容的字节数，这个字节数不包括后面类型转换过程中加上的0终止符。 下面是几个最安全和最简单的使用策略 sqlite3_column_xxx(sqlite3_stmt*,int iCol);
在sqlite3_step返回SQLITE_ROW后，使用它得到第iCol列的数据。 (2) int sqlite3_column_type(sqlite3_stmt*,int iCol);
返回值：SQLITE_INTEGER，SQLITE_FLOAT，SQLITE_TEXT，SQLITE_BLOB，SQLITE_NULL (3) int sqlite3_column_count(sqlite3_stmt *pStmt);
功能:获取列数 如果过程没有返回值，如update，将返回0 const char sqlite3_column_name(sqlite3_stmt,int); const char sqlite3_column_decltype(sqlite3_stmt ,int i); 类似： 得到当前行中包含的数据个数 ===================================================================================== 7.int sqlite3_reset(sqlite3_stmt *pStmt); int sqlite3_reset(sqlite3_stmt *pStmt);
功能:重置所有绑定的值,回到刚刚调用sqlite3_prepare后的状态 ===================================================================================== 8.sqlite3_finalize int sqlite3_finalize(sqlite3_stmt *pStmt); 这个过程销毁前面被sqlite3_prepare创建的准备语句，每个准备语句都必须使用这个函数去销毁以防止内存泄露。 在空指针上调用这个函数没有什么影响，同时可以准备语句的生命周期的任一时刻调用这个函数：在语句被执行前，一次或多次调用sqlite_reset之后，或者在sqlite3_step任何调用之后不管语句是否完成执行 sqlite3_finalize(pStmt); pStmt = NULL;
9.sqlite3_close 这个过程关闭前面使用sqlite3_open打开的数据库连接，任何与这个连接相关的准备语句必须在调用这个关闭函数之前被释放 int sqlite3_close(
sqlite3* pDB /* 由 sqlite3_open 或基相关的函数打开的 SQLite 对象句柄 */
);
说明: if(pDB != NULL)
{
sqlite3_close(pDB);
pDB = NULL;
}
===================================================================================== 10. int sqlite3_exec(
sqlite3* pDB,/* sqlite3句柄 */
const char* sql,/* 被执行的 SQL 语句 */
int (*callback)(void*,int,char**,char**),/* 执行/查询回调函数 */
void* pvoid,/* 传递给回调函数的第一个参数 */
char**errmsg /* 错误输出信息 */
);
说明: sqlite3_exec(pDB,to_utf8("delete from tablename where id=123;"),NULL,NULL);
sqlite3_exec(pDB,to_utf8("create table if not exists tablename (id integer primary key,name text);"),to_utf8("insert into tablename (name) values ('女孩不哭');"),NULL);
if(sqlite3_exec(pDB,to_utf8("select * from tablename;"),sqlite_callback,&pszErrMsg) != SQLITE_OK)
{
...
sqlite3_free(pszErrMsg);
pszErrMsg = NULL;
}
参阅:在 sqlite3 中使用回调函数(http://www.cnblogs.com/nbsofer/archive/2012/05/29/2523807.html) ===================================================================================== 11. int sqlite3_errcode(
sqlite3* pDB /* SQLite3 数据库句柄 */
);
说明: const char *sqlite3_errmsg(
sqlite3* pDB /* SQLite3 数据库句柄 */
);
说明: 13. ===================================================================================== int sqlite3_key(
sqlite3 *db,/* Database to be rekeyed */
const void *pKey,int nKey /* The key */
);
功能:为加密的数据库指定密码,改函数在sqlite3_open之后调用 14. ===================================================================================== int sqlite3_rekey(
sqlite3 *db,int nKey /* The new key */
);
功能:重设数据库密码,如果pKey = 0 或者 nKey = 0,这数据库不加密 ===================================================================================== 15. ===================================================================================== int sqlite3_get_table(
sqlite3*,/* An open database */
const char *sql,/* SQL to be executed */
char ***resultp,/* Result written to a char *[] that this points to */
int *nrow,/* Number of result rows written here */
int *ncolumn,/* Number of result columns written here */
char **errmsg /* Error msg written here */
);
功能:查询表 16. ===================================================================================== void sqlite3_free_table(char **result);
功能:释放通过sqlite3_get_table查询保存的结果数据 ===================================================================================== int sqlite3_create_function(
sqlite3 *,const char *zFunctionName,int nArg,int eTextRep,void*,void (*xFunc)(sqlite3_context*,sqlite3_value**),void (*xStep)(sqlite3_context*,void (*xFinal)(sqlite3_context*)
);
功能: const void *sqlite3_value_blob(sqlite3_value*);
int sqlite3_value_bytes(sqlite3_value*);
int sqlite3_value_bytes16(sqlite3_value*);
double sqlite3_value_double(sqlite3_value*);
int sqlite3_value_int(sqlite3_value*);
sqlite_int64 sqlite3_value_int64(sqlite3_value*);
const unsigned char *sqlite3_value_text(sqlite3_value*);
const void *sqlite3_value_text16(sqlite3_value*);
const void *sqlite3_value_text16le(sqlite3_value*);
const void *sqlite3_value_text16be(sqlite3_value*);
int sqlite3_value_type(sqlite3_value*);
int sqlite3_value_numeric_type(sqlite3_value*);
功能:类似sqlite3_column_*函数 其他： const char *sqlite3_libversion(void); sqlite_int64 sqlite3_last_insert_rowid(sqlite3*); int sqlite3_changes(sqlite3*); int sqlite3_total_changes(sqlite3*); void sqlite3_interrupt(sqlite3*); int sqlite3_complete(const char *sql); int sqlite3_busy_handler(sqlite3*,int()(void,int),void*); int sqlite3_busy_timeout(sqlite3*,int ms); char sqlite3_mprintf(const char,…); void *sqlite3_malloc(int); int sqlite3_set_authorizer( void sqlite3_trace(sqlite3,void(xTrace)(void,void*); void sqlite3_progress_handler(sqlite3*,int()(void),void*); void sqlite3_commit_hook(sqlite3,void*); int sqlite3_errcode(sqlite3 *db); int sqlite3_bind_parameter_count(sqlite3_stmt*); const char sqlite3_bind_parameter_name(sqlite3_stmt,int); int sqlite3_bind_parameter_index(sqlite3_stmt*,const char *zName); int sqlite3_clear_bindings(sqlite3_stmt*); 参考代码： #include <stdio.h>
#include "sqlite3.h"
int main(){
sqlite3 *db;
char *zErrMsg = NULL;
int rv;
char szSql[128] = { 0 };
sqlite3_stmt *stmt;
rv = sqlite3_open("test.db",&db);
if(rv){
fprintf(stderr,"Can't open database: %sn",sqlite3_errmsg(db));
sqlite3_close(db);
return 1;
}
else
fprintf(stderr,"sqlite3_open OKn");
//这里查询时，假定数据库中存在表test，并且有一列为COL1(text类型)
strcpy(szSql,"SELECT COL1 FROM test where COL1=?");
rv = sqlite3_prepare(db,szSql,128,&stmt,NULL);
if( rv != SQLITE_OK ) {
fprintf(stderr,"sqlite3_prepare(%d): %sn",rv,sqlite3_errmsg(db));
return -1;
}
rv = sqlite3_bind_text(stmt,1,"VALUE1",strlen("VALUE1"),SQLITE_STATIC);
if( rv != SQLITE_OK ) {
fprintf(stderr,"sqlite3_bind_text(%d): %sn",sqlite3_errmsg(db));
return -1;
}
rv = sqlite3_step(stmt);
if( (rv != SQLITE_OK) && (rv != SQLITE_DONE) && (rv != SQLITE_ROW) ) {
fprintf(stderr,"sqlite3_step(%d): %sn",sqlite3_errmsg(db));
return -1;
}
while( rv == SQLITE_ROW ){
fprintf(stderr,"result: %sn",sqlite3_column_text(stmt,0));
rv = sqlite3_step(stmt);
}
rv = sqlite3_finalize(stmt);
if( rv != SQLITE_OK ) {
fprintf(stderr,"sqlite3_finalize(%d): %sn",sqlite3_errmsg(db));
return -1;
}
sqlite3_close(db);
return 0;
}
===================================================================================== #include "stdafx.h"
#include "sqlite3.h"
static int callback( void*NotUsed,int argc,char **argv,char **azColName)
{
int i;
for (i=0; i<argc; i++){
printf ( "%s = %s/n",azColName[i],argv[i] ? argv[i] :"NULL" );
}
printf ( "/n" );
return 0;
}
#define CHECK_RC(rc,szInfo,szErrMsg,db) if(rc!=SQLITE_OK) /
{ printf ( "%s error!/n",szInfo);/
printf ( "%s/n",szErrMsg); /
sqlite3_free(szErrMsg); /
sqlite3_close(db); /
return 0;}
int _tmain( int argc,_TCHAR* argv[])
{
sqlite3 *db;
char *dbPath= "f:/test.db";
char *szErrMsg = 0;
int rc= sqlite3_open(dbPath,&db);
CHECK_RC(rc,"open database",db);
char *szSql= "create table UserInfo(ID int primary key,UserName char,PassWord char);";
rc=sqlite3_exec(db,0,&szErrMsg);
CHECK_RC(rc,"create table",db);
rc=sqlite3_exec(db,"insert into UserInfo(ID,UserName,PassWord) values(1,'kfqcome','123456')",&szErrMsg);
CHECK_RC(rc,"insert info",PassWord) values(2,'miss wang','654321')",db);
szSql= "select * from UserInfo" ;
rc = sqlite3_exec(db,callback,"query values",db);
sqlite3_close(db);
getchar ();
return 0;
}
输出的结果：
ID = 1
UserName = kfqcome
PassWord = 123456
ID = 2
UserName = miss wang
PassWord = 654321 （编辑：李大同） 【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容! |
- ruby-on-rails – Rails sprockets 3.0 find_asset
- ruby-on-rails – FactoryGirl问题 – “工厂”：错误的参数
- ruby-on-rails – 用于管理员的Rails Base Controller
- react native Webview ios <Error>: CGAffineTran
- 全面介绍eBPF-概念
- com – 使用WiX注册ActiveX exe服务器
- xml-parsing – 使用JAXB和Unmarshaller的文件过早结束.响应
- c# – .NET Remoting被WCF取代？
- C++中将string类型转化为int类型
- cocos2d-x 2.x必须升级到2.26才能通过appstore对64bit支持的