sqlite3的C语言使用(一)
sqlite3的C语言使用(一)
前一天我讲了如何在VC中连接sqlite的库，从今天开始就分几个专题详细学习一下sqlite的一些API。当然我也是才接触sqlite3，这些题也都是我的作业题，如果有什么错误大家可以联系我，共同进步。
0.准备工作
在代码头上加上这样一个宏定义：typedef struct sqlite3 sqlite3; 以后我们就可以将sqlite3视为一个新数据类型，表示一个sqlite3数据库句柄。
明确一下今天我们写的这个程序的目的（也就是我的作业题）：
通讯录管理软件。
通讯者信息包括：姓名、性别、手机、Email、地址。
软件功能：添加、查询、删除、全部输出。
1.sqlite3_open 打开或新建一个数据库文件
| 函数原型： int sqlite3_open( const char *filename, /* Database filename (UTF-8) */ sqlite3 **ppDb /* OUT: SQLite db handle */ ); |
|:----|
filename：数据库文件地址
ppDb:sqlite3数据库类型句柄。
函数作用是打开一个数据库文件，如果文件不存在，则创建之。所以我们的程序开头就是：
int _tmain(int argc, _TCHAR* argv[])
{
bool flag = true;
sqlite3 * db;
char szErr[256];
char * pErr;
int n;
int rc = sqlite3_open("addresslist.db",&db);
if (rc != SQLITE_OK)
{
printf("打开数据库出错\n");
return 0;
}2.sqlite3_exec 执行sql语句。（一般用来执行不用返回值的sql语句，如create table、update等）
| 函数原型 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数据库句柄，和sqlite3_open函数第2个参数一样。
sql:执行的sql语句。
第三个参数是个回调函数，在执行本函数后会执行回调函数，不用则填NULL。
第四个参数是传给回调函数的参数，不用则填NULL。
errmsg：出错信息，不用则填NULL。
这个函数可以执行一些非查询类的sql语句，很方便。我们在主函数里用sqlite3_exec来创建一个表：
const char * sql = "CREATE TABLE IF NOT EXISTS addlist( \
per_id INTEGER PRIMARY KEY, \
per_name VARCHAR(16) NOT NULL, \
per_sex VARCHAR(2), \
per_number VARCHAR(20), \
per_email VARCHAR(256), \
per_address varchar(256));";
rc = sqlite3_exec(db,sql,NULL,NULL,&pErr);
if (rc != SQLITE_OK)
{
printf("创建表失败\n");
return 0;
}sql语句的意思大家应该都知道，IF NOT EXIST如果表addlist不存在则创建它，当我们第二次运行时执行这个语句也不会再创建表了。
3.接下来就可以等待用户的输入了，我们可以给用户一些选择，比如选1表示要添加联系人，选2表示删除联系人，选3表示查询联系人。这个就一个swich语句完了，我就不发代码了。
再开始写函数，首先是添加联系人的函数AddPerson
void AddPerson(sqlite3 * db)
{
while (getchar() != '\n') ;
char szName[16],szSex[8],szNum[32],szEmail[256],szAddress[256];
printf("输入姓名(回车结束):");
gets(szName);
printf("输入性别(回车结束):");
gets(szSex);
printf("输入电话号码(回车结束):");
gets(szNum);
printf("输入e-mail(回车结束):");
gets(szEmail);
printf("输入地址(回车结束):");
gets(szAddress);
char sql[512];
sprintf(sql,"INSERT INTO addlist VALUES(null,'%s','%s','%s','%s','%s');",
szName,szSex,szNum,szEmail,szAddress);
int rc = sqlite3_exec(db,sql,NULL,NULL,NULL);
if (rc != SQLITE_OK)
{
printf("出错\n");
}
return ;
}没有用新的API，一个sqlite3_exec就解决了问题。
4.sqlite3_prepare 把一条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语句
nByte:如果nByte小于0，则函数取出zSql中从开始到第一个0终止符的内容；如果nByte不是负的，那么它就是这个函数能从zSql中读取的字节数的最大值。
pzTail：上面提到zSql在遇见终止符或者是达到设定的nByte之后结束，假如zSql还有剩余的内容，那么这些剩余的内容被存放到pZTail中，不包括终止符
ppStmt：能够使用sqlite3_step()执行的编译好的准备语句的句柄，如果错误发生，它被置为NULL，如假如输入的文本不包括sql语句。调用过程必须负责在编译好的sql语句完成使用后使用sqlite3_finalize()删除它。
我们这个函数将sql语句编译成二进制字节码，以便后面的函数使用，编译好的东西就是stmt(第五个参数)。别问我为什么，我也不知道，但要执行sql来查询就要编译。于是我们查询函数SelectPerson可以这么写：
void SelectPerson(sqlite3 * db)
{
char sql[256];
int per_num;
sqlite3_stmt * stmt;
printf("输入要查询的联系人编号:\n");
scanf("%d",&per_num);
sprintf(sql,"select * from addlist where per_id='%d'",per_num);
sqlite3_prepare(db,sql,-1,&stmt,NULL);5.sqlite3_step 执行编译好的sql语句，获得结果的一行
| 函数原型 int sqlite3_step(sqlite3_stmt*); |
|:----|
stmt:就是刚才执行sqlite3_prepare后得到的sql语句句柄。
这个函数很简单，执行sql语句，得到返回结果的一行。当然这个得到不是说从返回值得到，而是一个抽象的得到，要真正得到具体数据，还得利用其它函数。
因为是得到返回值的一行，所以说要用循环语句来得到所有行。当然如果只有一行就不用了。我们这里查询某个人的信息，结果应该只有一行，所以执行一次step就行。
这是SelectPerson函数剩下的部分：
if(sqlite3_step(stmt) == SQLITE_ROW)
{
printf("编号:%d 姓名:%s 性别:%s 电话:%s Email:%s 地址:%s\n",
sqlite3_column_int(stmt,0),sqlite3_column_text(stmt,1),sqlite3_column_text(stmt,2),
sqlite3_column_text(stmt,3),sqlite3_column_text(stmt,4),sqlite3_column_text(stmt,5));
}
else
{
printf("输入错误\n");
}
sqlite3_finalize(stmt);
return;
}6.如果要查询全部人的数据，sqlite3_step函数就要用while语句来循环读取了，我直接给代码：
void AllSelect(sqlite3 * db)
{
sqlite3_stmt * stmt;
sqlite3_prepare(db,"select * from addlist",-1,&stmt,NULL);
while(sqlite3_step(stmt) == SQLITE_ROW)
{
printf("编号:%d 姓名:%s 性别:%s 电话:%s Email:%s 地址:%s\n",
sqlite3_column_int(stmt,0),sqlite3_column_text(stmt,1),sqlite3_column_text(stmt,2),
sqlite3_column_text(stmt,3),sqlite3_column_text(stmt,4),sqlite3_column_text(stmt,5));
}
sqlite3_finalize(stmt);
return ;
}7.sqlite3_finalize 销毁sql语句句柄。这个函数很简单就不给原型了，记住创建了以后一定要销毁就行。
8.到现在，我们已经完成了3个任务了，添加联系人、查询联系人、列出所有联系人，最后再写一个删除联系人的函数就完成任务了：
void DelPerson(sqlite3 * db)
{
int n;
char sql[256];
printf("输入要删除的联系人编号:");
scanf("%d",&n);
sprintf(sql,"delete from addlist where per_id=%d",n);
int rc = sqlite3_exec(db,sql,NULL,NULL,NULL);
if(SQLITE_OK == rc)
{
printf("执行成功\n");
}
else
{
printf("删除失败\n");
}
return ;
}一个sqlite3_exec函数解决问题。
9.总结
这个题目写完了，我也介绍了一些常用的sqlite3的API，并没有想象中那么复杂。这是运行的截图，代码我不发了，如果想要可以联系我。
