要使用sqlite,需要从sqlite官网下载到三个文件,分别为sqlite3.lib,sqlite3.dll,sqlite3.h,然后再在自己的工程中配置好头文件和库文件,同时将dll文件放到当前目录下,就完成配置可以使用sqlite了。
使用的过程根据使用的函数大致分为如下几个过程:
1. sqlite3_open()
2. sqlite3_prepare()
3. sqlite3_step()
4. sqlite3_column()
5. sqlite3_finalize()
6. sqlite3_close()
这几个过程是概念上的说法,而不完全是程序运行的过程,如sqlite3_column()表示的是对查询获得一行里面的数据的列的各个操作统称,实际上在sqlite中并不存在这个函数。
1. sqlite3_open():打开数据库
在操作数据库之前,首先要打开数据库。这个函数打开一个sqlite数据库文件的连接并且返回一个数据库连接对象。这个操作同时程序中的第一个调用的sqlite函数,同时也是其他sqlite api的先决条件。许多的sqlite接口函数都需要一个数据库连接对象的指针作为它们的第一个参数。
int sqlite3_open(
const char *filename, /* Database filename (UTF-8) */
sqlite3 **ppDb /* OUT: SQLite db handle */
);
参数说明:
filename:需要被打开的数据库文件的文件名,在sqlite3_open和sqlite3_open_v2中这个参数采用UTF-8编码,而在sqlite3_open16中则采用UTF-16编码
ppDb:一个数据库连接句柄被返回到这个参数,即使发生错误。唯一的一场是如果sqlite不能分配内存来存放sqlite对象,ppDb将会被返回一个NULL值。
2. Sqlite3_prepare(): 准备数据库
这个函数将sql文本转换成一个准备语句(prepared statement)对象,同时返回这个对象的指针。这个接口需要一个数据库连接指针以及一个要准备的包含SQL语句的文本。它实际上并不执行(evaluate)这个SQL语句,它仅仅为执行准备这个sql语句
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 */
);
参数:
db:数据句柄
zSql:sql语句,使用UTF-8编码
nByte:如果nByte小于0,则函数取出zSql中从开始到第一个0终止符的内容;如果nByte不是负的,那么它就是这个函数能从zSql中读取的字节数的最大值。如果nBytes非负,zSql在第一次遇见’/000/或’u000’的时候终止
pzTail:上面提到zSql在遇见终止符或者是达到设定的nByte之后结束,假如zSql还有剩余的内容,那么这些剩余的内容被存放到pZTail中,不包括终止符
3. sqlite3_setp(): 数据库按步进行
这个过程用于执行有前面sqlite3_prepare创建的准备语句。这个语句执行到结果的第一行可用的位置。继续前进到结果的第二行的话,只需再次调用sqlite3_setp()。继续调用sqlite3_setp()知道这个语句完成,那些不返回结果的语句(如:INSERT,UPDATE,或DELETE),sqlite3_step()只执行一次就返回
int sqlite3_step(sqlite3_stmt*);
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()获得。
5. sqlite3_finalize: 销毁
int sqlite3_finalize(sqlite3_stmt *pStmt);
这个过程销毁前面被sqlite3_prepare创建的准备语句,每个准备语句都必须使用这个函数去销毁以防止内存泄露。
在空指针上调用这个函数没有什么影响,同时可以准备语句的生命周期的任一时刻调用这个函数:在语句被执行前,一次或多次调用sqlite_reset之后,或者在sqlite3_step任何调用之后不管语句是否完成执行
6. sqlite3_close: 关闭数据库
int sqlite3_close(sqlite3_stmt *pStmt);
这个过程关闭前面使用sqlite3_open打开的数据库连接,任何与这个连接相关的准备语句必须在调用这个关闭函数之前被释放
示例:
#include "stdafx.h"
<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 intoUserInfo(ID,UserName,PassWord)values(1,'zhangsan','666666')",0,0,&szErrMsg);
CHECK_RC(rc,"insert info",szErrMsg,db);
rc=sqlite3_exec(db,"insert into UserInfo(ID,UserName,PassWord) values(2,'lisi','111111')",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 = zhangsan
PassWord = 666666
ID = 2
UserName = lisi
PassWord = 111111