SQLITE3操作函数

数据库的打开：

函数原型: int sqlite3_open(const char* fileName, sqlite3** ppDB);
函数功能：打开一个数据库；若该数据库文件不存在，则自动创建。打开或者创建数据库的命令会被缓存，直到这个数据库真正被调用的时候才会被执行。
输入参数：fileName，待打开的数据库文件名称，包括路径，以’\0’结尾； 特别说明：SQLite 支持内存数据库，内存方式存储使用文件名“:memory:”
输出参数：ppDB,返回打开的数据库句柄；
返回值：执行成功返回SQLITE_OK，否则返回其他值；

数据库的关闭：

函数原型: int sqlite3_close(sqlite3* pDB);
函数功能：关闭一个打开的数据库；
输入参数：pDB,打开的数据库句柄
输出参数： 无
返回值：执行成功返回SQLITE_OK，否则返回其他值

数据库的调试：

函数原型:const char *sqlite3_errmsg(sqlite3* pDB);
函数功能：获取最近调用的API 接口返回的错误说明，这些错误信息UTF-8的编码返回，并且在下一次调用任何SQLite API 函数时被自动清除；
输入参数：pDB,打开的数据库句柄
输出参数： 无
返回值：错误说明的字符串指针

函数原型:int sqlite3_errcode(sqlite3* pDB);
函数功能：获取最近调用的API 接口返回的错误代码；
输入参数：pDB,打开的数据库句柄
输出参数： 无
返回值：错误代码

数据库的执行：

函数原型：int sqlite3_exec(sqlite3* pDB, const char *sql, sqlite_callback callback, void*para, char** errMsg);
函数功能：编译和执行零个或多个SQL 语句，查询的结果返回给回调函数callback
输入参数：pDB,数据库句柄；sql，待执行的SQL 语句字符串，以’\0’结尾；callback,回调函数，用来处理查询结果，如果不需要回调（比如做insert 或者delete 操作时），可以 输入NULL；para,用户传入的参数，可以为NULL，该参数指针最终会被传给回调函数callback,供用户在回调函数中使用；  
输出参数：errMsg,返回错误信息，注意是指针的指针。
返回值：执行成功返回SQLITE_OK，否则返回其他值

回调函数：

回调函数sqlite_callback介绍
typedef int (*sqlite_callback)(void* para,int columnCount,char** columnValue,char** columnName);
函数功能：由用户处理查询的结果
输入参数：para,从sqlite3_exec（）传入的参数指针；columnCount, 查询到的这一条记录有多少个字段(即这条记录有多少列)；columnValue，查询出来的数据都保存在这里，它实际上是个1 维数组（不要以为是2 维数组），每一个元素都是一个char * 值，是一个字段内容（用字符串来表示，以‘\0’结尾）；columnName，与columnValue 是对应的，表示这个字段的字段名称。
输出参数：无
返回值：执行成功返回SQLITE_OK，否则返回其他值

执行sql：

函数原型：int sqlite3_get_table(sqlite3* pDB, const char *sql,char ***pResult, int * rowCount,int * columnCount, char** errMsg);
函数功能：执行SQL 语句，通过一维数组返回结果；一般用于数据记录查询
输入参数：pDB,打开的数据库句柄；sql，待执行的SQL 字符串，以’\0’结尾；
输出参数：rowCount，查询出多少条记录（即查出多少行）；columnCount，查询出来的记录有多少个字段（多少列）； errMsg，返回错误信息；pResult，查询结果，是由字符串组成的一维数组（不要以为是二维数组，更不要以为是三维数组）。它的内存布局是：第一行是字段名称，后面紧接着每个字段的值；
返回值：执行成功返回SQLITE_OK，否则返回其他值

释放sql：

函数原型：void sqlite3_free_table(char **result);
函数功能：释放查询结果占用的内存；
输入参数：result,通过函数sqlite3_get_table（）查询到的记录结果
输出参数：无
返回值：无

实例代码：

#include <stdio.h>
#include <sqlite3.h>
#include <stdlib.h>

void create_table(sqlite3 *db)
{
    char *sql;
    char *errmsg;
    int ret;

	sql = "create table if not exists mytable (id integer primary key,name text);";

	ret = sqlite3_exec(db,sql,NULL,NULL,&errmsg);

	if(ret != SQLITE_OK)
	{
		printf("create table error : %s\n",errmsg);
		exit(-1);
	}
}

void insert_record(sqlite3 *db)
{
    char sql[100];
    char *errmsg;
    int ret;
	int id;
	char name[20];

	printf("please input id and name:\n");

	scanf("%d%s",&id,name);

	sprintf(sql,"insert into mytable (id,name)values(%d,'%s');",id,name);

	ret = sqlite3_exec(db,sql,NULL,NULL,&errmsg);

	if(ret != SQLITE_OK)
	{
		printf("insert record  error : %s\n",errmsg);
		exit(-1);
	}
#if 0	
	sql = "insert into mytable (id,name)values(NULL,'zhang');";

	ret = sqlite3_exec(db,sql,NULL,NULL,&errmsg);

	if(ret != SQLITE_OK)
	{
		printf("insert record  error : %s\n",errmsg);
		exit(-1);
	}
	
	sql = "insert into mytable (id,name)values(NULL,'lin');";

	ret = sqlite3_exec(db,sql,NULL,NULL,&errmsg);

	if(ret != SQLITE_OK)
	{
		printf("insert record  error : %s\n",errmsg);
		exit(-1);
	}
#endif
}

int displaycb(void *para,int ncolumn,char ** columnvalue,char *columnname[])
{
	int i;
	printf("total column is %d\n",ncolumn);

	for(i = 0;i < ncolumn; i++)
	{
		printf("col_name:%s----> clo_value:%s\n",columnname[i],columnvalue[i]);
	}
	printf("===========================\n");

	return 0;
}

void inquire_usecb(sqlite3 * db)
{
    char *sql;
    char *errmsg;
    int ret;

	sql = "select * from mytable;";

	ret = sqlite3_exec(db,sql,displaycb,NULL,&errmsg);

	if(ret != SQLITE_OK)
	{
		printf("select error : %s\n",errmsg);
		exit(-1);
	}

}

void inquire_nocb(sqlite3 *db)
{
    int nrow,ncolumn;
	char **azresult;
	char *sql;
	char *errmsg;
	int ret;
	int i;

	sql = "select * from mytable;";

    ret = sqlite3_get_table(db,sql,&azresult,&nrow,&ncolumn,&errmsg);

    if(ret != SQLITE_OK)
	{
		printf("get table error:%s",errmsg);
		exit(-1);
	}

	printf("nrow = %d,column = %d\n",nrow,ncolumn);
;

	sqlite3_free_table(azresult);
}

int main()
{
	sqlite3 *db;
	int ret;

	ret = sqlite3_open("mydatabase.db",&db);

	if(ret != SQLITE_OK)
	{
		printf("open database error : %s\n",sqlite3_errmsg(db));
		exit(-1);
	}
  else
	{
		printf("you have opened a database succefully!\n");
	}

	create_table(db);
	insert_record(db);
	//inquire_usecb(db);
    inquire_nocb(db);

	sqlite3_close(db);
    return 0;
}