sqlite3函数使用说明1

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