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,并没有想象中那么复杂。这是运行的截图,代码我不发了,如果想要可以联系我。

     点击查看原图

赞赏

喜欢这篇文章?打赏1元

评论

kid 回复

博主,我最近在写一个图书管理系统的作业,想用数据库,能发代码参考一下吗?O(∩_∩)O谢谢,1038210252@qq.com

phithon 回复

@kid:这个时间太久了,我也找不到代码了

kid 回复

@phithon:那打扰了

kaka 回复

406732298@qq.com 求代码

maomao 回复

1015787417@qq.com 求代码

captcha