Sqlite   发布时间:2022-05-22  发布网站:大佬教程  code.js-code.com
大佬教程收集整理的这篇文章主要介绍了sqlite3使用简介大佬教程大佬觉得挺不错的,现在分享给大家,也给大家做个参考。

sqlite3使用简介

一.使用流程

要使用sqlite,需要从sqlite官网下载到三个文件,分别为@R_489_2590@sqlite3.dllsqlite3.h,然后再在自己的工程中配置好头文件和库文件,同时将dll文件放到当前目录下,就完成配置可以使用sqlite了。

使用的过程根据使用的函数大致分为如下几个过程:

这几个过程是概念上的说法,而不完全是程序运行的过程,如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*/

intflags, /* Flags */

const char*zVfs /* name of VFS module to use*/

);

说明:

假如这个要被打开的数据文件不存在,则一个同名的数据库文件将被创建。如果使用sqlite3_opensqlite3_open_v2的话,数据库将采用UTF-8的编码方式,sqlite3_open16采用UTF-16的编码方式

返回值:

如果sqlite数据库被成功打开(或创建),将会返回@R_694_5607@OK,否则将会返回错误码。sqlite3_errmsg()或者sqlite3_errmsg16可以用于获得数据库打开错误码的英文描述,这两个函数定义为:

const char *sqlite3_errmsg(sqlite3*);

const void *sqlite3_errmsg16(sqlite3*);

参数说明:

filename:需要被打开的数据库文件的文件名,在sqlite3_opensqlite3_open_v2中这个参数采用UTF-8编码,而在sqlite3_open16中则采用UTF-16编码

ppDb一个数据库连接句柄被返回到这个参数,即使发生错误。唯一的异常是如果sqlite不能分配内存来存放sqlite对象,ppDb将会被返回一个NulL值。

flags:作为数据库连接的额外控制的参数,可以是@R_694_5607@OPEN_Readonly@R_694_5607@OPEN_READWRITE@R_694_5607@OPEN_READWRITE|@R_694_5607@OPEN_CREATE中的一个,用于控制数据库的打开方式,可以和@R_694_5607@OPEN_NOMUTEX@R_694_5607@OPEN_FULLMUTEX@H_808_696@@R_694_5607@OPEN_SHAREDCACHE,以及@R_694_5607@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 */

int nByte, /* Maximum length of zSQL inbytes. */

sqlite3_stmt **ppStmt, /* OUT: Statement handle */

const char **pzTail /* OUT: Pointer to unused portion of zSQL*/

);

int sqlite3_prepare_v2(

);

参数:

db:数据指针

zSQLsql语句,使用UTF-8编码

nByte:如果nByte小于0,则函数取出zSQL中从开始到第一个0终止符的内容;如果nByte不是负的,那么它就是这个函数能从zSQL中读取的字节数的最大值。如果nBytes非负,zSQL在第一次遇见’/000/’u000’的时候终止

pzTail:上面提到zSQL在遇见终止符或者是达到设定的nByte之后结束,假如zSQL还有剩余的内容,那么这些剩余的内容被存放到pZTail中,不包括终止符

ppStmt:能够使用sqlite3_step()执行的编译好的准备语句的指针,如果错误发生,它被置为NulL,如假如输入的文本不包括sql语句。调用过程必须负责在编译好的sql语句完成使用后使用sqlite3_finalize()删除它

说明

如果执行成功,则返回@R_694_5607@OK,否则返回一个错误码。推荐在现在任何的程序中都使用sqlite3_prepare_v2这个函数,sqlite3_prepare只是用于前向兼容

备注

<1>准备语句(prepared statement)对象

typedefstruct sqlite3_stmt sqlite3_stmt;

准备语句(prepared statement)对象一个代表一个简单sql语句对象的实例,这个对象通常被称为“准备语句”或者“编译好的sql语句”或者就直接称为“语句”。

语句对象的生命周期经历这样的过程:

l 使用sqlite3_prepare_v2或相关的函数创建这个对象

l 使用sqlite3_bind_*()给宿主参数(hostparameters)绑定值

l 通过调用sqlite3_step一次或多次来执行这个sql

l 使用sqlite3——reset()重置这个语句,然后回到第2步,这个过程做0次或多次

l 使用sqlite3_finalize()销毁这个对象

sqlite中并没有定义sqlite3_stmt这个结构的具体内容,它只是一个抽象类型,在使用过程中一般以它的指针进行操作,而sqlite3_stmt类型的指针在实际上是一个指向Vdbe的结构体得指针

<2>宿主参数(hostparameters)

在传给sqlite3_prepare_v2()sql的语句文本或者它的变量中,满足如下模板的文字将被替换成一个参数:

l ?

l ?NNNNNN代表数字

l :VVVVVV代表字符

l @VVV

l $VVV

在上面这些模板中,NNN代表一个数字,VVV代表一个字母数字标记符(例如:222表示名称为222的标记符),sql语句中的参数(变量)通过上面的几个模板来指定,如

SELEct ? from ? “这个语句中指定了两个参数,sqlite语句中的第一个参数的索引值是1,这就知道这个语句中的两个参数的索引分别为12,使用”?”的话会被自动给予索引值,而使用”?NNN”则可以自己指定参数的索引值,它表示这个参数的索引值为NNN”:VVV”表示一个名为”VVV”的参数,它也有一个索引值,被自动指定。

可以使用sqlite3_bind_*()来给这些参数绑定值

3 sqlite3_setp()

这个过程用于执行有前面sqlite3_prepare创建的准备语句。这个语句执行到结果的第一行可用的位置继续前进到结果的第二行的话,只需再次调用sqlite3_setp()。继续调用sqlite3_setp()知道这个语句完成,那些不返回结果的语句(如:INSERTupdatE,或deletE),sqlite3_step()只执行一次就返回

函数定义

int sqlite3_step(sqlite3_stmt*);

返回值

函数的返回值基于创建sqlite3_stmt参数所使用的函数,假如是使用老版本的接口sqlite3_prepare()sqlite3_prepare16(),返回值会是@R_694_5607@BUSY@R_694_5607@DONE@R_694_5607@ROW@R_694_5607@ERROR @R_694_5607@mISUSE,而v2版本的接口sqlite3_prepare_v2()sqlite3_prepare16_v2()则会同时返回这些结果码和扩展结果码。

对所有V3.6.23.1以及其前面的所有版本,需要在sqlite3_step()之后调用sqlite3_reset(),在后续的sqlite3_step之前。如果调用sqlite3_reset重置准备语句失败,将会导致sqlite3_ step返回@R_694_5607@mISUSE,但是在V3. 6.23.1以后,sqlite3_step()将会自动调用sqlite3_reset

int sqlite3_reset(sqlite3_stmt *pStmt);

sqlite3_reset用于重置一个准备语句对象到它的初始状态,然后准备被重新执行。所有sql语句变量使用sqlite3_bind*绑定值,使用sqlite3_clear_bindings重设这些绑定sqlite3_reset接口重置准备语句到它代码开始的时候。sqlite3_reset并不改变在准备语句上的任何绑定值,那么这里猜测,可能是语句在被执行的过程中发生了其他的改变,然后这个语句将它重置到绑定值的时候的那个状态。

4 sqlite3_column()

这个过程从执行sqlite3_step()执行一个准备语句得到的结果集的当前行中返回一个列每次sqlite3_step得到一个结果集的列停下后,这个过程就可以被多次调用去查询这个行的各列的值。对列操作是有多个函数,均以sqlite3_column为前缀

const void*sqlite3_column_blob(sqlite3_stmt*,int iCol);

intsqlite3_column_bytes(sqlite3_stmt*,191); margin:0cm 0cm 0pt 3.3pt; text-align:left; text-indent:17.7pt"> intsqlite3_column_bytes16(sqlite3_stmt*,191); margin:0cm 0cm 0pt 3.3pt; text-align:left; text-indent:17.7pt"> doublesqlite3_column_double(sqlite3_stmt*,191); margin:0cm 0cm 0pt 3.3pt; text-align:left; text-indent:17.7pt"> intsqlite3_column_int(sqlite3_stmt*,191); margin:0cm 0cm 0pt 3.3pt; text-align:left; text-indent:17.7pt"> sqlite3_int64sqlite3_column_int64(sqlite3_stmt*,191); margin:0cm 0cm 0pt 3.3pt; text-align:left; text-indent:17.7pt"> const unsigned char*sqlite3_column_text(sqlite3_stmt*,191); margin:0cm 0cm 0pt 3.3pt; text-align:left; text-indent:17.7pt"> const void*sqlite3_column_text16(sqlite3_stmt*,191); margin:0cm 0cm 0pt 3.3pt; text-align:left; text-indent:17.7pt"> intsqlite3_column_type(sqlite3_stmt*,191); margin:0cm 0cm 0pt 3.3pt; text-align:left; text-indent:17.7pt"> sqlite3_value*sqlite3_column_value(sqlite3_stmt*,int iCol);

说明

第一个参数为从sqlite3_prepare返回来的preparedstatement对象的指针,第二参数指定这一行中的想要被返回的列的索引。最左边的一列的索引号是0,行的列数可以使用sqlite3_colum_count()获得。

这些过程会根据情况去转换数值的类型,sqlite内部使用sqlite3_snprintf()去自动进行这个转换,下面是关于转换的细节表:

@H_607_2509@ @H_214_2607@

float

@H_214_2607@

TEXT

@H_214_2607@

BLOB

@H_214_2607@

整形的ASCII码显示

@H_214_2607@

浮点型的ASCII显示

@H_214_2607@

同上

内部类型

请求的类型

转换

NulL

IntegeR

结果是0

结果是0.0

结果是NulL

IntegeR

从整形转换到浮点型

float

浮点型转换到整形

TEXT

使用atoi()

TEXT

大佬总结

以上是大佬教程为你收集整理的sqlite3使用简介全部内容,希望文章能够帮你解决sqlite3使用简介所遇到的程序开发问题。

如果觉得大佬教程网站内容还不错,欢迎将大佬教程推荐给程序员好友。

本图文内容来源于网友网络收集整理提供,作为学习参考使用,版权属于原作者。
如您有任何意见或建议可联系处理。小编QQ:384754419,请注明来意。