前序:
sqlite3
的确很好用。小巧、速度快。但是因为非微软的产品,帮助文档总觉得不够。这些天再次研究它,又有一些收获,这里把我对
sqlite3
的研究列出来,以备忘记。
这里要注明,我是一个跨平台专注者,并不喜欢只用
windows
平台。我以前的工作就是为
unix
平台写代码。下面我所写的东西,虽然没有验证,但是我已尽量不使用任何
的东西,只使用标准
C
或标准
C++
。但是,我没有尝试过在别的系统、别的编译器下编译,因此下面的叙述如果不正确,则留待以后修改。
下面我的代码仍然用
VC
编写,因为我觉得
是一个很不错的
IDE
,可以加快代码编写速度(例如配合
Vassist
)。下面我所说的编译环境,是
VC2003
。如果读者觉得自己习惯于
下用
vi
编写代码速度较快,可以不用管我的说明,只需要符合自己习惯即可,因为我用的是标准
或
。不会给任何人带来不便。
一、
版本
从
www.sqlite.org
网站可下载到最新的
sqlite
代码和编译版本。我写此文章时,最新代码是
3.3.17
版本。
很久没有去下载
新代码,因此也不知道
变化这么大。以前很多文件,现在全部合并成一个
sqlite3.c
文件。如果单独用此文件,是挺好的,省去拷贝一堆文件还担心有没有遗漏。但是也带来一个问题:此文件太大,快接近
7
万行代码,
开它整个机器都慢下来了。如果不需要改它代码,也就不需要打开
文件,机器不会慢。但是,下面我要写通过修改
代码完成加密功能,那时候就比较痛苦了。如果个人水平较高,建议用些简单的编辑器来编辑,例如
UltraEdit
Notepad
。速度会快很多。
二、
基本编译
这个不想多说了,在
里新建
dos
控制台空白工程,把
和
sqlite3.h
添加到工程,再新建一个
main.cpp
文件。在里面写
:
extern "C"
{
#include "./sqlite3.h"
};
int main( int,char** )
{
return 0;
}
为什么要
extern “C”
?如果问这个问题,我不想说太多,这是
的基础。要在
里使用一段
的代码,必须要用
括起来。
跟
虽然语法上有重叠,但是它们是两个不同的东西,内存里的布局是完全不同的,在
编译器里不用
括起
代码,会导致编译器不知道该如何为
代码描述内存布局。
可能在
里人家已经把整段代码都
括起来了,但是你遇到一个
.c
文件就自觉的再括一次,也没什么不好。
基本工程就这样建立起来了。编译,可以通过。但是有一堆的
warning
。可以不管它。
三、
sqlITE
操作入门
sqlite
提供的是一些
函数接口,你可以用这些函数操作数据库。通过使用这些接口,传递一些标准
sql
语句(以
char *
类型)给
函数,
就会为你操作数据库。
MS
的
access
一样是文件型数据库,就是说,一个数据库就是一个文件,此数据库里可以建立很多的表,可以建立索引、触发器等等,但是,它实际上得到的就是一个文件。备份这个文件就备份了整个数据库。
不需要任何数据库引擎,这意味着如果你需要
来保存一些用户数据,甚至都不需要安装数据库
(
如果你做个小软件还要求人家必须装了
sqlserver
才能运行,那也太黑心了
)
。
下面开始介绍数据库基本操作。
(
1
)
基本流程
i.1
关键数据结构
里最常用到的是
sqlite3 *
类型。从数据库打开开始,
就要为这个类型准备好内存,直到数据库关闭,整个过程都需要用到这个类型。当数据库打开时开始,这个类型的变量就代表了你要操作的数据库。下面再详细介绍。
i.2
打开数据库
int sqlite3_open(
文件名
,sqlite3 ** );
用这个函数开始数据库操作。
需要传入两个参数,一是数据库文件名,比如:
c:\\DongChunGuang_Database.db
文件名不需要一定存在,如果此文件不存在,
会自动建立它。如果它存在,就尝试把它当数据库文件来打开。
sqlite3 **
参数即前面提到的关键数据结构。这个结构底层细节如何,你不要关它。
函数返回值表示操作是否正确,如果是
sqlITE_OK
则表示操作正常。相关的返回值
定义了一些宏。具体这些宏的含义可以参考
文件。里面有详细定义(顺便说一下,
的代码注释率自称是非常高的,实际上也的确很高。只要你会看英文,
可以让你学到不少东西)。
下面介绍关闭数据库后,再给一段参考代码。
i.3
关闭数据库
int sqlite3_close(sqlite3 *);
前面如果用
sqlite3_open
开启了一个数据库,结尾时不要忘了用这个函数关闭数据库。
下面给段简单的代码:
extern "C"
{
#include "./sqlite3.h"
};
int main( int,char** )
{
sqlite3 * db = NULL; //
声明
关键结构指针
int result;
//
//
需要传入
db
这个指针的指针,因为
函数要为这个指针分配内存,还要让
指针指向这个内存区
result = sqlite3_open( “c:\\Dcg_database.db”,&db );
if( result != sqlITE_OK )
{
//
数据库打开失败
return -1;
}
//
数据库操作代码
数据库打开成功
sqlite3_close( db );
return 0;
}
这就是一次数据库操作过程。
2
sql
语句操作
本节介绍如何用
执行标准
语法。
执行
语句
int sqlite3_exec(sqlite3*,const char *sql,sqlite3_callback,void *,char **errmsg );
这就是执行一条
语句的函数。
第
个参数不再说了,是前面
open
函数得到的指针。说了是关键数据结构。
个参数
const char *sql
是一条
语句,以
\0
结尾。
3
sqlite3_callback
是回调,当这条语句执行之后,
会去调用你提供的这个函数。(什么是回调函数,自己找别的资料学习)
4
void *
是你所提供的指针,你可以传递任何一个指针参数到这里,这个参数最终会传到回调函数里面,如果不需要传递指针给回调函数,可以填
NULL
。等下我们再看回调函数的写法,以及这个参数的使用。
5
char ** errmsg
是错误信息。注意是指针的指针。
里面有很多固定的错误信息。执行
sqlite3_exec
之后,执行失败时可以查阅这个指针(直接
printf(“%s\n”,errmsg)
)得到一串字符串信息,这串信息告诉你错在什么地方。
函数通过修改你传入的指针的指针,把你提供的指针指向错误提示信息,这样
函数外面就可以通过这个
char*
得到具体错误提示。
说明:通常,
和它后面的
这两个位置都可以填
。填
表示你不需要回调。比如你做
insert
操作,做
delete
操作,就没有必要使用回调。而当你做
select
时,就要使用回调,因为
把数据查出来,得通过回调告诉你查出了什么数据。
i.2 exec
的回调
typedef int (*sqlite3_callback)(void*,int,char**,char**);
你的回调函数必须定义成上面这个函数的类型。下面给个简单的例子:
//sqlite3
的回调函数
// sqlite
每查到一条记录,就调用一次这个回调
int LoadMyInfo( void * para,int n_column,char ** column_value,char ** column_name )
{
//para
是你在
里传入的
参数
//
通过
para
参数,你可以传入一些特殊的指针(比如类指针、结构指针),然后在这里面强制转换成对应的类型(这里面是
void*
类型,必须强制转换成你的类型才可用)。然后操作这些数据
//n_column
是这一条记录有多少个字段
即这条记录有多少列
)
// char ** column_value
是个关键值,查出来的数据都保存在这里,它实际上是个
维数组(不要以为是
维数组),每一个元素都是一个
值,是一个字段内容(用字符串来表示,以
结尾)
//char ** column_name
column_value
是对应的,表示这个字段的字段名称
这里,我不使用
参数。忽略它的存在
.
int i;
printf( “
记录包含
%d
个字段
\n”,n_column );
for( i = 0 ; i < n_column; i ++ )
{
printf( “
字段名
:%s ?>
字段值
:%s\n”,column_name[i],column_value[i] );
}
printf( “------------------\n“ );
return 0;
}
int main( int,char ** )
{
sqlite3 * db;
int result;
char * errmsg = NULL;
result = sqlite3_open( “c:\\Dcg_database.db”,51); font-size:16px; font-family:宋体">创建一个测试表,表名叫
MyTable_1
,有
个字段:
ID
name
。其中
是一个自动增加的类型,以后
时可以不去指定这个字段,它会自己从
0
开始增加
result = sqlite3_exec( db,“create table MyTable_1( ID integer primary key autoincrement,name nvarchar(32) )”,NULL,errmsg );
if(result != sqlITE_OK )
{
printf( “
创建表失败,错误码
:%d
,错误原因
插入一些记录
走路
’ )”,51); font-size:16px; font-family:宋体">插入记录失败,错误码
开始查询数据库
通过上面的例子,应该可以知道如何打开一个数据库,如何做数据库基本操作。
有这些知识,基本上可以应付很多数据库操作了。
不使用回调查询数据库
上面介绍的
是使用回调来执行
操作。还有一个方法可以直接查询而不需要回调。但是,我个人感觉还是回调好,因为代码可以更加整齐,只不过用回调很麻烦,你得声明一个函数,如果这个函数是类成员函数,你还不得不把它声明成
static
的(要问为什么?这又是
基础了。
成员函数实际上隐藏了一个参数:
this
,
调用类的成员函数的时候,隐含把类指针当成函数的第一个参数传递进去。结果,这造成跟前面说的
回调函数的参数不相符。只有当把成员函数声明成
时,它才没有多余的隐含的
参数)。
虽然回调显得代码整齐,但有时候你还是想要非回调的
查询。这可以通过
sqlite3_get_table
函数做到。
int sqlite3_get_table(sqlite3*,char ***resultp,int *nrow,int *ncolumn,51); font-size:16px; font-family:宋体">个参数不再多说,看前面的例子。
个参数是
语句,跟
里的
是一样的。是一个很普通的以
结尾的
字符串。
个参数是查询结果,它依然一维数组(不要以为是二维数组,更不要以为是三维数组)。它内存布局是:第一行是字段名称,后面是紧接着是每个字段的值。下面用例子来说事。
个参数是查询出多少条记录(即查出多少行)。
个参数是多少个字段(多少列)。
6
个参数是错误信息,跟前面一样,这里不多说了。
下面给个简单例子
:
int main( int,char ** )
{
sqlite3 * db;
int result;
char * errmsg = NULL;
char **dbResult; //
是
char **
类型,两个
*
号
int nRow,nColumn;
int i,j;
int index;
result = sqlite3_open( “c:\\Dcg_database.db”,51); font-size:16px; font-family:宋体">假设前面已经创建了
表
开始查询,传入的
dbResult
已经是
,这里又加了一个
&
取地址符,传递进去的就成了
char ***
result = sqlite3_get_table( db,&dbResult,&nRow,&nColumn,&errmsg );
if( sqlITE_OK == result )
{
//
查询成功
index = nColumn; //
前面说过
前面第一行数据是字段名称,从
nColumn
索引开始才是真正的数据
printf( “
查到
条记录
for( j = 0 ; j < nColumn; j++ )
{
printf( “
的字段值是连续的,从第
索引到第
nColumn - 1
索引都是字段名称,从第
索引开始,后面都是字段值,它把一个二维的表(传统的行列表示法)用一个扁平的形式来表示
}
printf( “-------\n” );
}
}
//
到这里,不论数据库查询是否成功,都释放
char**
查询结果,使用
提供的功能来释放
sqlite3_free_table( dbResult );
//
到这个例子为止,
的常用用法都介绍完了。
用以上的方法,再配上
语句,完全可以应付绝大多数数据库需求。
但有一种情况,用上面方法是无法实现的:需要
、
二进制。当需要处理二进制数据时,上面的方法就没办法做到。下面这一节说明如何插入二进制数据