SQLite3在IOS中的用法
{http://blog.csdn.net/mamong/article/details/8365466} 使用的过程根据使用的函数大致分为如下几个过程:
这几个过程是概念上的说法,而不完全是程序运行的过程,如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) */ int sqlite3_open_v2( 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( 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 ( ?,? ); $id,name );用来支持Tcl变量的扩展语法,除非使用Tcl编程,否则推荐使用“:<name>”版本。 可以使用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*)); 4. sqlite3_step() 这个过程用于执行有前面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); sqlite3_reset用于重置一个准备语句对象到它的初始状态,然后准备被重新执行。所有sql语句变量使用sqlite3_bind*绑定值,使用sqlite3_clear_bindings重设这些绑定。Sqlite3_reset接口重置准备语句到它代码开始的时候。sqlite3_reset并不改变在准备语句上的任何绑定值,那么这里猜测,可能是语句在被执行的过程中发生了其他的改变,然后这个语句将它重置到绑定值的时候的那个状态。 它的返回值相对有些特殊。返回SQLITE_BUSY表示暂时无法执行操作,SQLITE_DONE表示操作执行完毕,SQLITE_ROW表示执行完毕并且有返回(执行select语句时)。当返回值为SQLITE_ROW时,我们需要对查询结果进行处理,SQLITE3提供sqlite3_column_*系列函数。 const unsigned char *sqlite3_column_text(sqlite3_stmt*,int iCol); 其中参数iCol为列的序号,从0开始。如果返回值有多行,则可以再次调用sqlite3_step函数,然后由sqlite3_column_*函数取得返回值。使用上述这些函数基本上可以完成对SQLITE3数据库的操作了(不过我这里只针对text数据类型做了说明)。 6. sqlite3_column() 这个过程从执行sqlite3_step()执行一个准备语句得到的结果集的当前行中返回一个列。每次sqlite3_step得到一个结果集的列停下后,这个过程就可以被多次调用去查询这个行的各列的值。对列操作是有多个函数,均以sqlite3_column为前缀 const void *sqlite3_column_blob(sqlite3_stmt*,int iCol); int sqlite3_column_bytes(sqlite3_stmt*,simkai;">int sqlite3_column_bytes16(sqlite3_stmt*,simkai;">double sqlite3_column_double(sqlite3_stmt*,simkai;">int sqlite3_column_int(sqlite3_stmt*,simkai;">sqlite3_int64 sqlite3_column_int64(sqlite3_stmt*,simkai;">const void *sqlite3_column_text16(sqlite3_stmt*,simkai;">int sqlite3_column_type(sqlite3_stmt*,simkai;">int sqlite3_column_numeric_type(sqlite3_stmt*,int iCol); sqlite3_value *sqlite3_column_value(sqlite3_stmt*,simkai;">第一个参数为从sqlite3_prepare返回来的prepared statement对象的指针,第二参数指定这一行中的想要被返回的列的索引。最左边的一列的索引号是0,行的列数可以使用sqlite3_colum_count()获得。 这些过程会根据情况去转换数值的类型,sqlite内部使用sqlite3_snprintf()去自动进行这个转换,下面是关于转换的细节表: |