C/C++之SQLite常用函数

C/C++之SQLite常用函数  

2010-06-03 15:43:06|  分类： 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);