出处：http://www.cnblogs.com/kfqcome/archive/2011/06/27/2136999.html
一、创建一个MFC窗口工程，把上节创建的LIB和DLL和sqlite3.h拷贝到工程目录，由于我想让工程必须依赖数据运行，所以采用静态连接方式。
#include "sqlite3.h"
#pragma comment(lib, "SQLiteDll.lib") //添加库文件
定义全部变量：
sqlite3* conn;
二、创建数据库
下面这个三个数据库，用于打开或创建一个本地数据库文件，如果要打开的指定文件不存在，则创建一个指定文件。
SQLITE_API int sqlite3_open(
const char *filename, /* Database filename (UTF-8) */
sqlite3 **ppDb /* OUT: SQLite db handle */
);
SQLITE_API int sqlite3_open16(
const void *filename, /* Database filename (UTF-16) */
sqlite3 **ppDb /* OUT: SQLite db handle */
);
SQLITE_API int sqlite3_open_v2(
const char *filename, /* Database filename (UTF-8) */
sqlite3 **ppDb, /* OUT: SQLite db handle */
int flags, /* Flags */
const char *zVfs /* Name of VFS module to use */
);
说明：
假如这个要被打开的数据文件不存在，则一个同名的数据库文件将被创建。如果使用sqlite3_open和sqlite3_open_v2的话，数据库将采用UTF-8的编码方式，sqlite3_open16采用UTF-16的编码方式
返回值：
如果sqlite数据库被成功打开（或创建），将会返回SQLITE_OK，否则将会返回错误码。Sqlite3_errmsg()或者sqlite3_errmsg16可以用于获得数据库打开错误码的英文描述，这两个函数定义为：
const char *sqlite3_errmsg(sqlite3*);
const void *sqlite3_errmsg16(sqlite3*);
#define SQLITE_OPEN_READONLY 0x00000001 /* Ok for sqlite3_open_v2() */ #define SQLITE_OPEN_READWRITE 0x00000002 /* Ok for sqlite3_open_v2() */ #define SQLITE_OPEN_CREATE 0x00000004 /* Ok for sqlite3_open_v2() */ #define SQLITE_OPEN_DELETEONCLOSE 0x00000008 /* VFS only */ #define SQLITE_OPEN_EXCLUSIVE 0x00000010 /* VFS only */ #define SQLITE_OPEN_AUTOPROXY 0x00000020 /* VFS only */ #define SQLITE_OPEN_URI 0x00000040 /* Ok for sqlite3_open_v2() */ #define SQLITE_OPEN_MEMORY 0x00000080 /* Ok for sqlite3_open_v2() */ #define SQLITE_OPEN_MAIN_DB 0x00000100 /* VFS only */ #define SQLITE_OPEN_TEMP_DB 0x00000200 /* VFS only */ #define SQLITE_OPEN_TRANSIENT_DB 0x00000400 /* VFS only */ #define SQLITE_OPEN_MAIN_JOURNAL 0x00000800 /* VFS only */ #define SQLITE_OPEN_TEMP_JOURNAL 0x00001000 /* VFS only */ #define SQLITE_OPEN_SUBJOURNAL 0x00002000 /* VFS only */ #define SQLITE_OPEN_MASTER_JOURNAL 0x00004000 /* VFS only */ #define SQLITE_OPEN_NOMUTEX 0x00008000 /* Ok for sqlite3_open_v2() */ #define SQLITE_OPEN_FULLMUTEX 0x00010000 /* Ok for sqlite3_open_v2() */ #define SQLITE_OPEN_SHAREDCACHE 0x00020000 /* Ok for sqlite3_open_v2() */ #define SQLITE_OPEN_PRIVATECACHE 0x00040000 /* Ok for sqlite3_open_v2() */ #define SQLITE_OPEN_WAL 0x00080000 /* VFS only */
2． Sqlite3_prepare()
这个函数将sql文本转换成一个准备语句（prepared statement）对象，同时返回这个对象的指针。这个接口需要一个数据库连接指针以及一个要准备的包含SQL语句的文本。它实际上并不执行（evaluate）这个SQL语句，它仅仅为执行准备这个sql语句
函数定义（仅列出UTF-8的）
int sqlite3_prepare(
sqlite3 *db, /* Database handle */
const char *zSql, /* SQL statement, UTF-8 encoded */
int nByte, /* Maximum length of zSql in bytes. */
sqlite3_stmt **ppStmt, /* OUT: Statement handle */
const char **pzTail /* OUT: Pointer to unused portion of zSql */
);
int sqlite3_prepare_v2(
sqlite3 *db, /* Database handle */
const char *zSql, /* SQL statement, UTF-8 encoded */
int nByte, /* Maximum length of zSql in bytes. */
sqlite3_stmt **ppStmt, /* OUT: Statement handle */
const char **pzTail /* OUT: Pointer to unused portion of zSql */
);
参数：
db：数据指针
zSql：sql语句，使用UTF-8编码
nByte：如果nByte小于0，则函数取出zSql中从开始到第一个0终止符的内容；如果nByte不是负的，那么它就是这个函数能从zSql中读取的字节数的最大值。如果nBytes非负，zSql在第一次遇见’/000/或’u000’的时候终止
pzTail：上面提到zSql在遇见终止符或者是达到设定的nByte之后结束，假如zSql还有剩余的内容，那么这些剩余的内容被存放到pZTail中，不包括终止符
ppStmt：能够使用sqlite3_step()执行的编译好的准备语句的指针，如果错误发生，它被置为NULL，如假如输入的文本不包括sql语句。调用过程必须负责在编译好的sql语句完成使用后使用sqlite3_finalize()删除它。
说明
如果执行成功，则返回SQLITE_OK，否则返回一个错误码。推荐在现在任何的程序中都使用sqlite3_prepare_v2这个函数，sqlite3_prepare只是用于前向兼容
备注
<1>准备语句（prepared statement）对象
typedef struct sqlite3_stmt sqlite3_stmt;
准备语句（prepared statement）对象一个代表一个简单SQL语句对象的实例，这个对象通常被称为“准备语句”或者“编译好的SQL语句”或者就直接称为“语句”。
语句对象的生命周期经历这样的过程：
l 使用sqlite3_prepare_v2或相关的函数创建这个对象
l 使用sqlite3_bind_*()给宿主参数（host parameters）绑定值
l 通过调用sqlite3_step一次或多次来执行这个sql
l 使用sqlite3——reset()重置这个语句，然后回到第2步，这个过程做0次或多次
l 使用sqlite3_finalize()销毁这个对象
在sqlite中并没有定义sqlite3_stmt这个结构的具体内容，它只是一个抽象类型，在使用过程中一般以它的指针进行操作，而sqlite3_stmt类型的指针在实际上是一个指向Vdbe的结构体得指针
<2>宿主参数(host parameters)
在传给sqlite3_prepare_v2()的sql的语句文本或者它的变量中，满足如下模板的文字将被替换成一个参数：
l ?
l ?NNN，NNN代表数字
l :VVV，VVV代表字符
l @VVV
l $VVV
在上面这些模板中，NNN代表一个数字，VVV代表一个字母数字标记符（例如:222表示名称为222的标记符），sql语句中的参数（变量）通过上面的几个模板来指定，如
“select ? from ? “这个语句中指定了两个参数，sqlite语句中的第一个参数的索引值是1，这就知道这个语句中的两个参数的索引分别为1和2，使用”?”的话会被自动给予索引值，而使用”?NNN”则可以自己指定参数的索引值，它表示这个参数的索引值为NNN。”:VVV”表示一个名为”VVV”的参数，它也有一个索引值，被自动指定。
可以使用sqlite3_bind_*()来给这些参数绑定值
3． sqlite3_setp()
这个过程用于执行有前面sqlite3_prepare创建的准备语句。这个语句执行到结果的第一行可用的位置。继续前进到结果的第二行的话，只需再次调用sqlite3_setp()。继续调用sqlite3_setp()知道这个语句完成，那些不返回结果的语句（如：INSERT，UPDATE，或DELETE），sqlite3_step()只执行一次就返回
函数定义
int sqlite3_step(sqlite3_stmt*);
返回值
函数的返回值基于创建sqlite3_stmt参数所使用的函数，假如是使用老版本的接口sqlite3_prepare()和sqlite3_prepare16()，返回值会是 SQLITE_BUSY， SQLITE_DONE， SQLITE_ROW， SQLITE_ERROR 或 SQLITE_MISUSE，而v2版本的接口sqlite3_prepare_v2()和sqlite3_prepare16_v2()则会同时返回这些结果码和扩展结果码。
对所有V3.6.23.1以及其前面的所有版本，需要在sqlite3_step()之后调用sqlite3_reset()，在后续的sqlite3_ step之前。如果调用sqlite3_reset重置准备语句失败，将会导致sqlite3_ step返回SQLITE_MISUSE，但是在V3. 6.23.1以后，sqlite3_step()将会自动调用sqlite3_reset。
int sqlite3_reset(sqlite3_stmt *pStmt);
sqlite3_reset用于重置一个准备语句对象到它的初始状态，然后准备被重新执行。所有sql语句变量使用sqlite3_bind*绑定值，使用sqlite3_clear_bindings重设这些绑定。Sqlite3_reset接口重置准备语句到它代码开始的时候。sqlite3_reset并不改变在准备语句上的任何绑定值，那么这里猜测，可能是语句在被执行的过程中发生了其他的改变，然后这个语句将它重置到绑定值的时候的那个状态。
4． sqlite3_column()
这个过程从执行sqlite3_step()执行一个准备语句得到的结果集的当前行中返回一个列。每次sqlite3_step得到一个结果集的列停下后，这个过程就可以被多次调用去查询这个行的各列的值。对列操作是有多个函数，均以sqlite3_column为前缀
const void *sqlite3_column_blob(sqlite3_stmt*, int iCol);
int sqlite3_column_bytes(sqlite3_stmt*, int iCol);
int sqlite3_column_bytes16(sqlite3_stmt*, int iCol);
double sqlite3_column_double(sqlite3_stmt*, int iCol);
int sqlite3_column_int(sqlite3_stmt*, int iCol);
sqlite3_int64 sqlite3_column_int64(sqlite3_stmt*, int iCol);
const unsigned char *sqlite3_column_text(sqlite3_stmt*, int iCol);
const void *sqlite3_column_text16(sqlite3_stmt*, int iCol);
int sqlite3_column_type(sqlite3_stmt*, int iCol);
sqlite3_value *sqlite3_column_value(sqlite3_stmt*, int iCol);
说明
第一个参数为从sqlite3_prepare返回来的prepared statement对象的指针，第二参数指定这一行中的想要被返回的列的索引。最左边的一列的索引号是0，行的列数可以使用sqlite3_colum_count()获得。
这些过程会根据情况去转换数值的类型，sqlite内部使用sqlite3_snprintf()去自动进行这个转换，下面是关于转换的细节表：
| 内部类型 | 请求的类型 | 转换 |
| NULL | INTEGER | 结果是0 |
| NULL | FLOAT | 结果是0.0 |
| NULL | TEXT | 结果是NULL |
| NULL | BLOB | 结果是NULL |
| INTEGER | FLOAT | 从整形转换到浮点型 |
| INTEGER | TEXT | 整形的ASCII码显示 |
| INTEGER | BLOB | 同上 |
| FLOAT | INTEGER | 浮点型转换到整形 |
| FLOAT | TEXT | 浮点型的ASCII显示 |
| FLOAT | BLOB | 同上 |
| TEXT | INTEGER | 使用atoi() |
| TEXT | FLOAT | 使用atof() |
| TEXT | BLOB | 没有转换 |
| BLOB | INTEGER | 先到TEXT，然后使用atoi |
| BLOB | FLOAT | 先到TEXT，然后使用atof |
| BLOB | TEXT | 如果需要的话添加0终止符 |
注：BLOB数据类型是指二进制的数据块，比如要在数据库中存放一张图片，这张图片就会以二进制形式存放，在sqlite中对应的数据类型就是BLOB
int sqlite3_column_bytes(sqlite3_stmt*, int iCol)int sqlite3_column_bytes16(sqlite3_stmt*, int iCol)两个函数返回对应列的内容的字节数，这个字节数不包括后面类型转换过程中加上的0终止符。
下面是几个最安全和最简单的使用策略
- 先sqlite3_column_text() ，然后 sqlite3_column_bytes()
- 先sqlite3_column_blob()，然后sqlite3_column_bytes()
- 先sqlite3_column_text16()，然后sqlite3_column_bytes16()
5． sqlite3_finalize
int sqlite3_finalize(sqlite3_stmt *pStmt);
这个过程销毁前面被sqlite3_prepare创建的准备语句，每个准备语句都必须使用这个函数去销毁以防止内存泄露。
在空指针上调用这个函数没有什么影响，同时可以准备语句的生命周期的任一时刻调用这个函数：在语句被执行前，一次或多次调用sqlite_reset之后，或者在sqlite3_step任何调用之后不管语句是否完成执行
6． sqlite3_close
这个过程关闭前面使用sqlite3_open打开的数据库连接，任何与这个连接相关的准备语句必须在调用这个关闭函数之前被释放
二．使用举例
#include "stdafx.h"
#include "sqlite3.h"
static
int
callback(
void
*NotUsed,
int
argc,
char
**argv,
char
**azColName)
{
int
i;
for
(i=0; i<argc; i++){
printf
(
"%s = %s/n"
, azColName[i], argv[i] ? argv[i] :
"NULL"
);
}
printf
(
"/n"
);
return
0;
}
#define CHECK_RC(rc,szInfo,szErrMsg,db) if(rc!=SQLITE_OK) /
{
printf
(
"%s error!/n"
,szInfo);/
printf
(
"%s/n"
,szErrMsg); /
sqlite3_free(szErrMsg); /
sqlite3_close(db); /
return
0;}
int
_tmain(
int
argc, _TCHAR* argv[])
{
sqlite3 *db;
char
*dbPath=
"f:/test.db"
;
char
*szErrMsg = 0;
int
rc= sqlite3_open(dbPath, &db);
CHECK_RC(rc,
"open database"
,db);
char
*szSql=
"create table UserInfo(ID int primary key , UserName char, PassWord char);"
;
rc=sqlite3_exec(db,szSql,0,0,&szErrMsg);
CHECK_RC(rc,
"create table"
,szErrMsg,db);
rc=sqlite3_exec(db,
"insert into UserInfo(ID,UserName,PassWord) values(1,'kfqcome','123456')"
,0,0,&szErrMsg);
CHECK_RC(rc,
"insert info"
,szErrMsg,db);
rc=sqlite3_exec(db,
"insert into UserInfo(ID,UserName,PassWord) values(2,'miss wang','654321')"
,0,0,&szErrMsg);
CHECK_RC(rc,
"insert info"
,szErrMsg,db);
szSql=
"select * from UserInfo"
;
rc = sqlite3_exec(db,szSql, callback, 0, &szErrMsg);
CHECK_RC(rc,
"query values"
,szErrMsg,db);
sqlite3_close(db);
getchar
();
return
0;
}
|
输出的结果：
ID = 1
UserName = kfqcome
PassWord = 123456
ID = 2
UserName = miss wang
PassWord = 654321
这里执行sql语句用的是sqlite3_exec，它是前面几个函数的封装
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 */
);
sqlite3_exec是sqlite3_prepare_v2，sqlite3_step()和sqlite3_finalize()的封装，能让程序多次执行sql语句而不要写许多重复的代码。
Sqlite3_exec接口执行0或多个UTF-8编码的，分号分割的sql语句，传到第二个参数中。如果sqlite3_exec的第三个参数回调函数指针不为空，那么它会为每个来自执行的SQL语句的结果行调用（也就是说回调函数会调用多次，上面例子中会返回2个结果行，因而会被执行2次），第4个参数是传给回调函数的第一个参数，如果回调函数指针为空，那么回调不会发生同时结果行被忽略。
如果在执行sql语句中有错误发生，那么当前的语句的执行被停止，后续的语句也被跳过。第五个参数不为空的时候，它被分配内存并写入了错误信息，所以在sqlite3_exec后面需要调用sqlite3_free去释放这个对象以防止内存泄露
回调函数：
int (*callback)(void*,int,char**,char**), /* Callback function */
第一个参数通过sqlite3_exec的第第四个参数传入的
第二个参数是结果行的列数
第三个参数是行中列数据的指针
第四个参数是行中列名称的指针
扫一扫
1950
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
