C/C++之SQLite常用函数 - 简单的日志 - 网易博客
1 、打开数据库:
说明:打开一个数据库,文件名不一定要存在,如果此文件不存在, sqlite 会自动创建。第一个参数指文件名,第二个参数则是定义的 sqlite3 ** 结构体指针(关键数据结构),这个结构底层细节如何,您不用管它。
int sqlite3_open(
const char *filename, /* Database filename (UTF-8) */
sqlite3 **ppDb /* OUT: SQLite db handle */
);
返回值:表示操所是否正确( SQLITE_OK 操作正常)2、关闭数据库:
说明:如果用 sqlite3_open 开启了一个数据库,结尾时不要忘了用这个函数关闭数据库。
int sqlite3_close(sqlite3*); // 参数就是刚才的结构体,也就是数据库句柄
//注意在此出错后,可以用sqlite3_errmsg(db)来获得错误代码3 、执行 SQL 语句:
说 明:这个函数的功能是执行一条或者多条 SQL语句,SQL 语句之间用 “;” 号隔开。建议在执行一条或者多条 SQL 语句得时候,指定第三个参数回调函数,在 回调函数中可以获得执行 Sql 得详细过程,如果所有 Sql 执行完毕则应该返回 0 ,否则,则说明这次执行并没有完全成功。第五个参数:如果执行失败(没有返回 0 )则可以查看第五个阐述得值。来查看详细错误信息。
int sqlite3_exec(
sqlite3*, /* 已经打开的数据库句柄 */
const char *sql, /* 要执行的 Sql 语句 */
sqlite_callback, /* 回调函数 */
void *, /* 传递给回调函数的参数 */
char **errmsg /* 保存错误信息,注意用sqlite3_free(errmsg)来释放资源 */
);
通常sqlite3_callback和后面的void*这两个位置都可以填 NULL,表示不需要回调。比如您做 insert,update,delete操作,就没有必要使用回调。而当作select时,就要使用回调,因为 sqlite3把数据查出来,得通过回调告诉你查出了什么数据。4 、 exec 的回调
typedef int (*sqlite3_callback)(void* data, int col_count, char** col_value, char** col_name);
说明:你的回调函数必须定义为上面这个函数的类型。
// select_callback是select的回调函数
// @data : 是sqlite3_exec()中的第四个参数
// @col_count : 选择出来的列的个数
// @col_values: 每条记录每一列的数值
// @col_Name : 每一列的列名
static int select_callback(void * data, int col_count, char ** col_values, char ** col_Name)#include "../sqlite3_lib/sqlite3.h" // 头文件 #pragma comment(lib, "../sqlite3_lib/sqlite3.lib") // lib静态库 // select_callback是select的回调函数 // @data : 是sqlite3_exec()中的第四个参数 // @col_count : 选择出来的列的个数 // @col_values: 每条记录每一列的数值 // @col_Name : 每一列的列名 static int select_callback(void * notused, int argc, char ** values, char ** colName) { // 每条记录回调一次该函数,有多少条就回调多少次 int i; for ( i=0; i < argc; i++ ) { printf( "%s = %s\n", colName[i], values[i] == 0 ? "NUL" : values[i] ); } return 0; } int main(int argc, char * argv[]) { const char * sSQL1 = "create table users(userid varchar(20) PRIMARY KEY, age int, birthday datetime);"; char * pErrMsg = 0; // 连接数据库 sqlite3 * db = 0; int ret = sqlite3_open("./test.db", &db); if ( ret != SQLITE_OK ) { fprintf(stderr, "无法打开数据库: %s", sqlite3_errmsg(db)); return(1); } printf("数据库连接成功!\n"); // 执行建表SQL sqlite3_exec( db, sSQL1, 0, 0, &pErrMsg ); if ( ret != SQLITE_OK ) { fprintf(stderr, "SQL error: %s\n", pErrMsg); sqlite3_free(pErrMsg); } // 执行插入记录SQL sqlite3_exec( db, "insert into users values('张三',20,'2001-5-4');", 0, 0, &pErrMsg); sqlite3_exec( db, "insert into users values('李四',20,'1970-5-4');", 0, 0, &pErrMsg); // 查询数据表 sqlite3_exec( db, "select * from users;", select_callback, 0, &pErrMsg); // 关闭数据库 sqlite3_close(db); db = 0; return 0; }5 、取当前插入位置:
long long int sqlite3_last_insert_rowid(sqlite3*);
功能:返回你前一次插入得位置,从1开始,sqlite3*为你打开数据库所得到得句柄。6、非回调select查询:
功能:执行一次查询 Sql 并且返回得到一个记录集。
int sqlite3_get_table(
sqlite3*, /* 已经打开的数据库句柄 */
const char *sql, /* 要执行的 Sql 语句 */
char ***resultp, /* 保存返回记录集的指针 */
int *nrow, /* 返回记录数(多少行) */
int *ncolumn, /* 返回字段数(多少列) */
char **errmsg /* 返回错误信息 */
)
说明:第三个参数是查询结果,它是一维数组,内存布局为(n行m列结果),那么数组的0到m-1行是列名,m到2*m-1是记录集的第一行数据,以后的以此类推;#include "../sqlite3_lib/sqlite3.h" // 头文件 #pragma comment(lib, "../sqlite3_lib/sqlite3.lib") // lib静态库 int main( int , char ** ) { sqlite3 * db; int result; char * errmsg = NULL; char **dbResult; int nRow, nColumn; int i , j; int index; // 打开数据库 result = sqlite3_open( "./test.db", &db ); if( result != SQLITE_OK ) { return -1; } // 数据库操作代码 // 假设前面已经创建了 MyTable_1 表 // 开始查询,传入的dbResult已经是char**,这里又加了一个&取地址符,传递进去的就成了char*** result = sqlite3_get_table( db, "select * from users;", &dbResult, &nRow, &nColumn, &errmsg ); if( SQLITE_OK == result ) { // 查询成功 printf( "查到 %d 条记录,ncolumn=%d \n", nRow, nColumn); for( i = 1; i <= nRow ; i++ ) { printf( "第 %d 条记录 \n", i ); for( j = 0 ; j < nColumn; j++ ) { printf( " 字段名 :%s > 字段值 :%s\n", dbResult[j], dbResult[i*nColumn + j] ); // dbResult的字段值是连续的,从第0索引到第nColumn-1索引都是字段名称,从第nColumn索引开始, // 后面都是字段值,它把一个二维的表(传统的行列表示法)用一个扁平的形式来表示 } printf( "-------\n" ); } } // 到这里,不论数据库查询是否成功,都释放 char** 查询结果,使用 sqlite 提供的功能来释放 sqlite3_free_table( dbResult ); // 关闭数据库 sqlite3_close( db ); return 0; }7 、释放查询结果:
功能:释放当前查询的记录集所占用的内存
void sqlite3_free_table(char **result);