sqlite3 学习笔记

============================================================================================
sqlite3 学习笔记
============================================================================================
--------------------------------------------------------------------------------------------
1.数据库的打开与关闭
--------------------------------------------------------------------------------------------

实例代码：
sqlite3 * db = NULL; //声明sqlite关键结构指针
int result;
//打开数据库，有则打开，没有则按照路径自动创建
//需要传入 db 这个指针的指针，因为 sqlite3_open 函数要为这个指针分配内存，还要让db指针指向这个内存区
result = sqlite3_open( "./Dcg_database.db",&db );
if( result != SQLITE_OK )
{
//数据库打开失败
return -1;
}
…………
//关闭数据库
sqlite3_close( db );
-------------------------------------------------------------------------------------------
2.SQL语句操作
--------------------------------------------------------------------------------------------

int sqlite3_exec(sqlite3*,const char *sql,sqlite3_callback,void *,char **errmsg );

这就是执行一条 sql 语句的函数。

第1个参数不再说了，是前面open函数得到的指针。说了是关键数据结构。

第2个参数const char *sql 是一条 sql 语句，以/0结尾。

第3个参数sqlite3_callback 是回调，当这条语句执行之后，sqlite3会去调用你提供的这个函数。（什么是回调函数，自己找别的资料学习）

第4个参数void * 是你所提供的指针，你可以传递任何一个指针参数到这里，这个参数最终会传到回调函数里面，如果不需要传递指针给回调函数，可以填NULL。等下我们再看回调函数的写法，以及这个参数的使用。

第 5个参数char ** errmsg 是错误信息。注意是指针的指针。sqlite3里面有很多固定的错误信息。执行 sqlite3_exec 之后，执行失败时可以查阅这个指针（直接 printf(“%s/n”,errmsg)）得到一串字符串信息，这串信息告诉你错在什么地方。sqlite3_exec函数通过修改你传入的指针的指针，把你提供的指针指向错误提示信息，这样sqlite3_exec函数外面就可以通过这个 char*得到具体错误提示。

说明：通常，sqlite3_callback 和它后面的 void * 这两个位置都可以填 NULL。填NULL表示你不需要回调。比如你做 insert 操作，做 delete 操作，就没有必要使用回调。而当你做 select 时，就要使用回调，因为 sqlite3 把数据查出来，得通过回调告诉你查出了什么数据。

-------------------------------------------------------------------------------------------
3.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是你在 sqlite3_exec 里传入的 void * 参数
//通过para参数，你可以传入一些特殊的指针（比如类指针、结构指针），然后在这里面强制转换成对应的类型（这里面是void*类型，必须强制转换成你的类型才可用）。然后操作这些数据
//n_column是这一条记录有多少个字段 (即这条记录有多少列)
// char ** column_value 是个关键值，查出来的数据都保存在这里，它实际上是个1维数组（不要以为是2维数组），每一个元素都是一个 char * 值，是一个字段内容（用字符串来表示，以/0结尾）
//char ** column_name 跟 column_value是对应的，表示这个字段的字段名称
//这里，我不使用 para 参数。忽略它的存在.
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;
}
---------------------------------------------------------------------------------------------
4.使用回调函数查询数据库示例代码：
--------------------------------------------------------------------------------------------

//使用回调函数查询数据库，如果数据库中内容为空，则不会调用回调函数。同样，如果数据库内容为空，使用下面的非回调函数查询方法，返回的azResult中也是全空。

//sqlite3的回调函数
// sqlite 每查到一条记录，就调用一次这个回调
int LoadMyInfo( void * para,char ** column_name )
{
//这里，我不使用 para 参数。忽略它的存在.
int i;
printf( "记录包含 %d 个字段\n",column_value[i] );
}
printf( "------------------\n");
return 0;
}
int main( int,char ** )
{
sqlite3 * db;
int result;
char * * errmsg = NULL;
result = sqlite3_open( "./Dcg_database.db",&db );
if( result != SQLITE_OK )
{
//数据库打开失败
return -1;
}

//数据库操作代码
//创建一个测试表，表名叫 MyTable_1，有2个字段： ID 和 name。其中ID是一个自动增加的类型，以后insert时可以不去指定这个字段，它会自己从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，错误原因:%s\n",result,errmsg );
}

//插入一些记录
result = sqlite3_exec( db,"insert into MyTable_1( name ) values ( '走路' )",errmsg );
if(result != SQLITE_OK )
{
printf( "插入记录失败，错误码:%d，错误原因:%s\n",errmsg );
}
result = sqlite3_exec( db,"insert into MyTable_1( name ) values ( '骑单车' )","insert into MyTable_1( name ) values ( '坐汽车’')",errmsg );
}

//开始查询数据库
result = sqlite3_exec( db,"select * from MyTable_1",LoadMyInfo,errmsg );

//关闭数据库
sqlite3_close( db );
return 0;
}
--------------------------------------------------------------------------------------------
通过上面的例子，应该可以知道如何打开一个数据库，如何做数据库基本操作。
有这些知识，基本上可以应付很多数据库操作了。
下面介绍不使用回调函数查询数据库，但不推荐这样做
--------------------------------------------------------------------------------------------
--------------------------------------------------------------------------------------------
5.不使用回调查询数据库
--------------------------------------------------------------------------------------------

上面介绍的 sqlite3_exec 是使用回调来执行 select 操作。还有一个方法可以直接查询而不需要回调。但是，我个人感觉还是回调好，因为代码可以更加整齐，只不过用回调很麻烦，你得声明一个函数，如果这个函数是类成员函数，你还不得不把它声明成 static 的（要问为什么？这又是C++基础了。C++成员函数实际上隐藏了一个参数：this，C++调用类的成员函数的时候，隐含把类指针当成函数的第一个参数传递进去。结果，这造成跟前面说的 sqlite 回调函数的参数不相符。只有当把成员函数声明成 static 时，它才没有多余的隐含的this参数）。

虽然回调显得代码整齐，但有时候你还是想要非回调的 select 查询。这可以通过 sqlite3_get_table 函数做到。

int sqlite3_get_table(sqlite3*,char ***resultp,int *nrow,int *ncolumn,char **errmsg );

第1个参数不再多说，看前面的例子。
第2个参数是 sql 语句，跟 sqlite3_exec 里的 sql 是一样的。是一个很普通的以/0结尾的char *字符串。
第3个参数是查询结果，它依然一维数组（不要以为是二维数组，更不要以为是三维数组）。它内存布局是：第一行是字段名称，后面是紧接着是每个字段的值。下面用例子来说事。
第4个参数是查询出多少条记录（即查出多少行）。
第5个参数是多少个字段（多少列）。
第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( "./Dcg_database.db",&db );
if( result != SQLITE_OK )
{

//数据库打开失败
return -1;
}

//数据库操作代码
//假设前面已经创建了 MyTable_1 表
//开始查询，传入的 dbResult 已经是 char **，这里又加了一个 & 取地址符，传递进去的就成了 char ***
result = sqlite3_get_table( db,&dbResult,&nRow,&nColumn,&errmsg );
if( SQLITE_OK == result )
{
//查询成功

index = nColumn; //前面说过 dbResult 前面第一行数据是字段名称，从 nColumn 索引开始才是真正的数据
printf( "查到%d条记录\n",nRow );
for( i = 0; i < nRow ; i++ )
{
printf( "第 %d 条记录\n",i+1 );
for( j = 0 ; j < nColumn; j++ )
{
printf( "字段名:%s ß> 字段值:%s\n",dbResult[j],dbResult [index] );
++index; // dbResult 的字段值是连续的，从第0索引到第 nColumn - 1索引都是字段名称，从第 nColumn 索引开始，后面都是字段值，它把一个二维的表（传统的行列表示法）用一个扁平的形式来表示
}
printf( "-------\n" );
}
}
//到这里，不论数据库查询是否成功，都释放 char** 查询结果，使用 sqlite 提供的功能来释放
sqlite3_free_table( dbResult );

//关闭数据库
sqlite3_close( db );
return 0;
}

到这个例子为止，sqlite3 的常用用法都介绍完了。

用以上的方法，再配上 sql 语句，完全可以应付绝大多数数据库需求。

============================================================================================
引用自http://www.cnblogs.com/hnrainll/archive/2011/09/08/2170506.html
============================================================================================

附一个数据库操作代码及对应Makefile代码： ----------------------------------- sqlite.c ----------------------------------- #include<stdio.h> #include<sqlite3.h> int main(int argc,char **argv) { sqlite3 *db=NULL; char **errmsg=0; int rc; int nrow=0,ncolumn=0; char **azResult; int i=0; //此处可插入判断参数个数的代码 rc=sqlite3_open("./advdb",&db); if( rc ){ fprintf(stderr,"Can't open database: %s\n",sqlite3_errmsg(db)); sqlite3_close(db); return 0; } //创建表，ID自增 rc=sqlite3_exec(db,"create table MyTable( ID integer primary key autoincrement,Operate char(5))",errmsg); if( rc ){ fprintf(stderr,"Can't create table: %s\n",sqlite3_errmsg(db)); sqlite3_close(db); return 0; } //表中插入数据 rc=sqlite3_exec(db,"insert into MyTable(Operate) values('p0')",errmsg); if(rc!=SQLITE_OK) { printf("insert p0 error!\n"); } //表中插入数据 rc=sqlite3_exec(db,"insert into MyTable(Operate) values('p1')",errmsg); if(rc!=SQLITE_OK) { printf("insert p1 error!\n"); } //将数据全部选择并打印 sqlite3_get_table(db,"select *from MyTable",&azResult,&nrow,&ncolumn,errmsg); printf("row=%d,column=%d\n",nrow,ncolumn); printf("The result of querying is :\n"); for(i=0;i<(nrow+1)*ncolumn;i++) { printf("azResult[%d]=%s\n",i,azResult[i]); } sqlite3_close(db); return 0; } ------------------------------------ Makefile ------------------------------------ OBJ=sqlite route=/usr/local/sqlite-arm #exec_prefix=${route} libdir=${route}/lib includedir=${route}/include Libs = -L${libdir} -lsqlite3 -lpthread Cflags = -I${includedir} CROSS_COMPILE = arm-linux- CC = $(CROSS_COMPILE)gcc LD = $(CROSS_COMPILE)ld $(OBJ): $(OBJ).o $(CC) $^ $(Libs) -o $@ $(OBJ).o: $(OBJ).c $(CC) $(Cflags) -c $^ -o $@ clean: rm -rf $(OBJ) *.o ------------------------------------------------------------------------------------------------