SQlite数据库的C编程接口(五)
便捷函数(Convenience Functions) by斜风细雨QQ:253786989 2012-02-07
SQlite拥有很多早期遗留下来的便捷函数,这些函数存在很多缺点。当然他们依然存在就有理由——使用方便。
它们的优点也仅仅是使用方便,而不是具有很好的性能。相反,它们的性能会比直接调用PUBLICAPI函数更差一些。对于这些便捷函数,它们并没有什么特别之处,只是在这些函数内部调用sqlite3_prepare_xxx、sqlite3_step、sqlite3_finalize等API函数来完成一站式功能。在这样的函数内部往往存在很多额外的类型转换,所以这些函数很可能会比我们自己去调用sqlite3_prepare_xxx、sqlite3_step、sqlite3_finalize等API执行的更慢一些。
其次,这些API不支持参数绑定。就像上一篇笔记中介绍的,这样的程序更容易遭到“SQL注入攻击”,安全性更差。
总之,作者JayA.Kreibich非常不推荐使用这些便捷函数。正如他说的:“Ifyou’rejusttryingtothrowtogetheraquickanddirtysnippetofcode,thesefunctionsprovideaneasymeansofdoingthat.Istronglyrecommendusingthenormalprepare,step,andfinalizeroutines.You’llendupwithsafercodeandbetterperformance.”
(1)
- intsqlite3_exec(
-
sqlite3*,
-
constchar*sql,
-
int(*callback)(void*,int,char**,char**),
-
void*,
-
char**errmsg
- );
int sqlite3_exec(
sqlite3*, /* An open database */
const char *sql, /* SQL to be evaluated */
int (*callback)(void*,int,char**,char**), /* Callback function */
void *, /* 1st argument to callback */
char **errmsg /* Error msg written here */
);
预处理(prepare)和执行(execute)一条或多条SQL语句,对结果集的每一行调用其第3个参数所指向的回调函数。第1个参数指向一个有效的数据库连接。第2个参数是UTF-8编码的SQL语句(可以包含一条,或多条:以分号隔开)。第3个参数是一个指向回调函数的指针,如果不需要使用回调函数,可以给该参数传递NULL。第4个参数也是一个指针,用来传递用户数据到回调函数。需要注意的是,比如该指针由sqlite3_malloc获得,则要在其不再使用时调用sqlite3_free函数释放。第5个参数是一个指向指针的指针,通过该参数返回错误码。如果在sqlite3_exec执行过程中,没有遇到任何错误,最后函数将返回SQLITE_OK。
比如sqlite3_exec正在执行SELECT查询操作,而且想对返回结果进行处理。那就要传递一个回调函数给sqlite3_exec。这样sqlite3_exec函数每次获取一行数据,就会调用该回调函数。如果sqlite3_exec正在执行的操作不返回数据,就直接给sqlite3_exec函数的第3个参数传递NULL就可以了。
回调函数原型:
- intuser_defined_exec_callback(void*userData,intnumCol,char**colData,char**colName)
int user_defined_exec_callback( void *userData, int numCol, char **colData, char **colName )
第1个参数对应于sqlite3_exec函数的第4个参数,用于传递用户数据。第2个参数指明结果集中一共有多少列。第3个参数保存当前数据行的数据,第4个参数保存当前数据行的所有列的列名。第3个参数和第4个参数都是以字符串的形式返回。
正常情况下,回调函数应该返回0,如果它返回一个非0值,则sqlite3_exec函数将终止执行,并返回SQLITE_ABORT错误码。
(2)
- intsqlite3_get_table(
-
sqlite3*db,
-
constchar*zSql,
-
char***pazResult,
-
int*pnRow,
-
int*pnColumn,
-
char**pzErrmsg
- );
int sqlite3_get_table(
sqlite3 *db, /* An open database */
const char *zSql, /* SQL to be evaluated */
char ***pazResult, /* Results of the query */
int *pnRow, /* Number of result rows written here */
int *pnColumn, /* Number of result columns written here */
char **pzErrmsg /* Error msg written here */
);
这个函数与sqlite3_exec函数不同,它只在SQL命令字符串执行完成之后,返回全部的结果数据。该函数是专门针对SELECT语句设计的。
第1个参数是指向数据库连接的指针。第2个参数是UTF-8编码的SQL命令字符串。第3个参数看起来有点复杂,通过该参数返回SQL语句执行结果。首先该参数是一个指针,它指向一个一维数组,这个一维数组里面保存的元素类型是字符串指针。第4个和第5个参数返回结果集中的行数和列数。最后一个参数返回错误码。
函数执行完成返回的结果集中,包含(nColumn*(nRow+1))个数据项。其中多出来的一行是列名,剩下的nColumn*nRom项是数据。
如果sqlite3_get_table函数执行过程中没遇到任何错误,最后会返回SQLITE_OK。
下面是对结果集的一个访问例子,获取结果集中第R行,第C列的数据:
-
intoffset=((R+1)*numCol)+C;
-
char*value=result[offset];
/* offset to access column C of row R of **result */
int offset = ((R + 1) * numCol) + C;
char *value = result[offset];
传递给sqlite3_get_table函数的SQL命令字符串可以包含多条SELECT语句。但是,对于这多条SELECT语句的返回结果全部存储在pazResult所指向的一维数组中。没有办法确定一维数组中,哪些行数据是哪个SELECT语句检索出来的。并且所有的SELECT语句所返回的列数必须相同,否则sqlite3_get_table函数执行失败。除此之外,只有第一条语句会返回列名,存储在结果集一维数组的第一行中。基于以上原因,最好在每次调用sqlite3_get_table函数时使用单独一条SQL命令。
(3)
- voidsqlite3_free_table(char**result);
void sqlite3_free_table(char **result);
由sqlite3_get_table函数返回的结果集,所占用的内存,需要由sqlite3_free_table函数来释放。
SQlite数据库的C编程接口(五)
便捷函数(Convenience Functions) by斜风细雨QQ:253786989 2012-02-07
分享到:
相关推荐
Qt(由挪威TrollTech公司开发)是一个功能全面、高性 能、多平台的C++图形用户界面...境下以一个编程实例讲解Qt中SQLite数据库的应用编程过 程,向读者展示利用Qt与SQLite数据库开发嵌入式数据库应 用程序的一般方法。
c语言调用sqlite数据库中表的内容,非常实用
这是一个使用C#开发的Sqlite数据库创建、操作的源码工程,关于Sqlite的所有操作已经单独创建了专门的跨平台【.NETCore3.1】类库包含相应的帮助类,可以直接生成后拿到任何项目中直接使用,高效简单,省去了从头开发...
实验十 使用SQLite数据库存储数据
基于Qt4的SQLite数据库应用编程.pdf
SQlite数据库工具 供比较两个SQLite数据库所用。
前情提要:Android 数据库(SQLite) 【简介、创建、使用(增删改查、事务、实战演练)、数据显示控件(ListView、Adapter、实战演练)】 https://blog.csdn.net/weixin_44949135/article/details/105955663 Android ...
SQLite数据库加密解密小工具,只用于.Net中使用SQLite时的加密和加密
linux下c语言操作sqlite3数据库,有sqlite3动态库、sqlite3的源码安装包、c语言操作sqlite3数据库的封装函数。保证C语言能够正常对sqlite3进行增、删、改、查操作。已经在多个项目上使用,绝对可行。
php读取SQLite数据库, php读取SQLite数据库,php读取SQLite数据库
Sqlite数据库加密、解密工具,主要是用于进行给Sqlite数据库进行加密,修改密码的工具
Qt中SQlite数据库加密SqliteCipher 操作实例,打开多个数据库,附着数据库跨库查询, 对应说明:https://blog.csdn.net/woguanni/article/details/120524602
Android实验报告Sqlite数据库操作.pdf
在学习的过程中遇到了配置问题是主要的,能得找bug找了大半天,但是还是坚持的心态把问题给解决了,比如需要哪几个文件,需要sqlite3.dll、sqlite3.lib、sqlite3i.h、sqlite3.hDbsqlite.h、Dbsqlite.cpp这些都是已经...
sqlite数据库文件经多次添加删除操作后 文件占用磁盘空间过大 c++压缩文件代码 sqlite数据库文件经多次添加删除操作后 文件占用磁盘空间过大 c++压缩文件代码 测试调用TestFunction.h文件 bool commit_vacuum...
sqlite3 数据库 的API接口函数以及编程
SQLite介绍 SQLite的发展 SQLite的优势 SQLite的缺憾 SQLite的内部结构 SQLite数据库的使用 SQLite的命令行接口 SQLite命令行使用 SQLite数据库的编程接口 C/C++接口 简单应用 ...
本文实例讲述了C#操作SQLite数据库之读写数据库的方法。分享给大家供大家参考,具体如下: 这里演示读写数据库并在窗体(Form)中显示其数据,其方式为: 读: Database(SQLite) -> DataAdapter -> DataSet -> ...
Android源码——数据库SQLite.zip
delphi7用ASGSQlite3访问sqlite数据库实例: 1、用aducom sqlite3连接数据库,操作非常简单,跟用ado访问一样 2、用Navicat制作数据库,显示正常,但数据库中是乱码,不影响程序运行时的显示。 3、支持在设计时显示...