数据库函数：sqlite3_exec（）SQL语句
函数：sqlite3_exec（），称为便捷函数，封装了好多任务。
函数声明：
int sqlite3_exec( sqlite * , const char * sql , sqlite_callback , void *data , char ** errmmsg) ; 其中 sqlite* 表⽰打开的数据库；sql 为执⾏的sql语句；callback回
调函数；void *data为回调函数的第⼀个参数指向提供给回调函数的应⽤程序特定的数据，也是回调函数的第⼀个参数； errmsg 为错误信息，是指向错误消息字符串的指针。
sqlite_exec() 有两个错误消息来源，返回值和可读的字符串errmsg。
注意：如果提供了errmsg，⽤来创建错误消息的内存是在堆上分布的。故在调⽤后，应该检查⼀下是否为null值，如果有错误发⽣，使⽤sqlite3_free（）释放errmsg占⽤的内存。
回调函数的声明：
typedef int ( * sqlite3_callback ) (void * , int , char ** ,char ** )；其中void *是为sqlite3_exec()第四个参
数提供的数据，int代表字段的数⽬，char** 便是⾏中字段名称的字符串的数组，char**表⽰字段ing成的字符串数组。
sqlite3_exec( )允许执⾏⼀批命令，并可以通过回调接⼝收集所有的返回数据。
Sqlite3 的确很好⽤。⼩巧、速度快。但是因为⾮微软的产品，帮助⽂档总觉得不够。这些天再次研究它，⼜有⼀些收获，这⾥把我对sqlite3 的研究列出来，以备忘记。
这⾥要注明，我是⼀个跨平台专注者，并不喜欢只⽤ windows 平台。我以前的⼯作就是为 unix 平台写代码。下⾯我所写的东西，虽然没有验证，但是我已尽量不使⽤任何 windows 的东西，只使⽤标准 C 或标准C++。但是，我没有尝试过在别的系统、别的编译器下编译，因此下⾯的叙述如果不正确，则留待以后修改。
下⾯我的代码仍然⽤ VC 编写，因为我觉得VC是⼀个很不错的IDE，可以加快代码编写速度（例如配合 Vassist ）。下⾯我所说的编译环境，是VC2003。如果读者觉得⾃⼰习惯于 unix 下⽤ vi 编写代码速度较快，可以不⽤管我的说明，只需要符合⾃⼰习惯即可，因为我⽤的是标准 C 或 C++ 。不会给任何⼈带来不便。
从⽹站可下载到最新的 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"
{sql 字符串转数组
#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提供的是⼀些C函数接⼝，你可以⽤这些函数操作数据库。通过使⽤这些接⼝，传递⼀些标准 sql 语句（以 char * 类型）给 sqlite 函数，sqlite 就会为你操作数据库。
sqlite 跟MS的access⼀样是⽂件型数据库，就是说，⼀个数据库就是⼀个⽂件，此数据库⾥可以建⽴很多的表，可以建⽴索引、触发器等等，但是，它实际上得到的就是⼀个⽂件。备份这个⽂件就备份了整个数据库。
sqlite 不需要任何数据库引擎，这意味着如果你需要 sqlite 来保存⼀些⽤户数据，甚⾄都不需要安装数据库(如果你做个⼩软件还要求⼈家必须装了sqlserver 才能运⾏，那也太⿊⼼了)。
下⾯开始介绍数据库基本操作。
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;
}
这就是⼀次数据库操作过程。
语句操作
本节介绍如何⽤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⾥⾯有很多固定的错误信息。执⾏ sq
lite3_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, “insert into MyTable_1( name ) values ( ‘骑单车’ )”, 0, 0, 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个参数是查询结果，它依然⼀维数组（不要以为是⼆维数组，更不要以为是三维数组）。它内存布局是：第⼀⾏是字段名称，后⾯是紧接着是每个字段的值。下⾯⽤例⼦来说事。
版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。
发表评论