Linux下sqlite3移植与编程

http://blog.csdn.net/water_cow/article/details/7517879

2、sqlite3编程 sqlite提供了一些C函数接口，通过向这些接口传入标准的sql语句可操作数据库。 2.1 sqlite3数据结构 sqlite3 *类型是sqlite3编程中最重要的数据类型，它贯穿数据库操作的始末。从数据库打开开始，sqlite就要为这个类型准备内存空间，直到数据库关闭。 2.2 sqlite3常用函数

 
  1. int sqlite3_open(constchar *filename, sqlite3 **ppdb); 
  2. int sqlite3_close(sqlite3 *db); 
  3. int sqlite3_exec(sqlite3 *db, constchar *sql, int (*sqlite3_callback)(void *,int, char**,char**), void *, char **errmsg); 
  4. char *sqlite3_mprintf(constchar*, va_list); 
  5. int sqlite3_free(char *); 
  6. int sqlite3_get_table(sqlite3 *, constchar *sql, char **resultp, int *nrow, int *ncolumn, char **errmsg); 
  7. void sqlite3_free_table(char **resultp);  
int sqlite3_open(const char *filename, sqlite3 **ppdb);
int sqlite3_close(sqlite3 *db);
int sqlite3_exec(sqlite3 *db, const char *sql, int (*sqlite3_callback)(void *,int, char**,char**), void *, char **errmsg);
char *sqlite3_mprintf(const char*, va_list);
int sqlite3_free(char *);
int sqlite3_get_table(sqlite3 *, const char *sql, char **resultp, int *nrow, int *ncolumn, char **errmsg);
void sqlite3_free_table(char **resultp);

前三个函数基本能满足所有对sqlite3数据库的操作，后四个可根据情选择使用。 1. 打开/创建数据库 int sqlite3_open(const char *filename, sqlite3 **ppdb); 其中，filename为需要创建或打开的数据库名；ppdb为前面提到的sqlite3类型。正确则返回SQLITE_OK，该变量由sqlite3.h定义。 例：

 
  1. sqlite3 *db; 
  2. sqlite_open("test.db", &db);  
sqlite3 *db;
sqlite_open("test.db", &db);

2. 关闭数据库 int sqlite3_close(sqlite3 *db); 例：

 
  1. sqlite3_close(db);  
sqlite3_close(db);

3. 构建sql语句 char *sqlite3_mprintf(const char*, va_list); int sqlite3_free(char *); sqlite3_mprintf( )的功能类似于sprintf( )函数，它们主要区别在于sprintf对存储的目标字符串需要先分配内存，而sqlite3_mprintf函数内已封装了内存分配操作，返回目标字符串的内存首地址。 sqlite3_mprintf( )与sqlite3_free( )总是成对出现，否则会造成内存泄露。 例：

 
  1. char *sql = NULL; 
  2. sql = sqlite3_mprintf("delete from %s where %s = %d;", val1, val2, val3); 
  3. ... 
  4. sqlite3_free(sql);  
char *sql = NULL;
sql = sqlite3_mprintf("delete from %s where %s = %d;", val1, val2, val3);
...
sqlite3_free(sql);

4. 执行sql语句(可带回调函数) int sqlite3_exec(sqlite3 *db, const char *sql, int (*sqlite3_callback)(void *,int, char**,char**), void *, char **errmsg); sqlite3_exec( )的功能是执行一条或多条sql语句，语句间用‘；’号隔开。执行成功返回SQLITE_OK; 形参说明： sqlite3 *db：sqlite3_open( )得到的sqlite3*指针。 const char *sql：要执行的标准sql语句。 int (*sqlite3_callback)(void *,int,char**,char**)：回调函数，执行完指定sql函数后所执行的函数，该函数的传参由sqlie3_exec( )执行sql语句后根据返回结果传入相应参数；回调函数每返回一行记录回调一次；回调函数必须定义成这个函数类型，若无需传入回调函数可直接置NULL。 void *：用户可传递一个任意类型的指针参数，该参数会传给回调函数使用；若无传参可直接置NULL。 char **errmsg：执行sql语句失败后返回的错误信息可通过该变量获取。 sqlite3_exec( )的回调函数 int (*sqlite3_callback)(void *,int,char**,char**); 例，回调函数的定义： int callback_fun(void *para, int n_column, char **column_value, char ** column_name); 形参说明： void *para：在sqlite3_exec( )函数传入void *的参数。 int n_column：存储一条记录的字段数，即列数。 char **column_value：保存记录的数据，它实际是个一维数组，每个元素都是一个char *值，以字符串数据方式记录一个字段的内容。 char **column_name：该参数跟column_value对应，保存该字段的名称。 例，回调函数的一个原型例子：

 
  1. int callback_fun(void *para, int n_column, char **column_value, char ** column_name) 
  2. { 
  3.     int i; 
  4.     printf("记录包含%d个字段(列)\n", n_column); //列数 
  5.     for(i = 0; i < n_column; i++) 
  6.     { 
  7.         printf("字段名:%s >> 字段值:%s\n", column_name, column_value); 
  8.     } 
  9.     return 0; 
  10. }  
int callback_fun(void *para, int n_column, char **column_value, char ** column_name)
{
    int i;
    printf("记录包含%d个字段(列)\n", n_column); //列数
    for(i = 0; i < n_column; i++)
    {
        printf("字段名:%s >> 字段值:%s\n", column_name, column_value);
    }
    return 0;
}

5. 非回调查询 int sqlite3_get_table(sqlite3 *, const char *sql, char **resultp, int *nrow, int *ncolumn, char **errmsg); void sqlite3_free_table(char **resultp); sqlite3_get_table( )跟sqlite_free_table( )不管查询是否成功，它们必须成对使用，否则会造成内存泄露。 sqlite3_get_table( )形参说明： sqlite3 *：sqlite3_open( )得到的sqlite3*指针。 const char *sql：要执行的标准sql语句。 char **resultp：保存字段的名称与值；resultp也是一个一维数组，它的内存布局是，第一行是字段名称，后面紧接是每个字段的值。 假如数据表一行数据记录包含3个字段：field1、field2、field3，各字段对应的值如下：   field1        field2         field3 val1_1       val2_1       val3_1 val1_2      val2_2       val3_2 则它们在resultp的内存分布如下：

resultp[0]

resultp[1]

resultp[2]

resultp[3]

resultp[4]

resultp[5]

resultp[6]

resultp[7]

resultp[8]
field1 field1 field1 val1_1 val2_1 val3_1 val1_2 val2_2 val3_2

int *nrow：保存记录的行数。 int *ncolumn：保存记录的字段数(列数)。 char **errmsg：执行sql语句失败后返回的错误信息可通过该变量获取。 例，sqlite3_get_table( )函数用法例子：

 

 
  1. int main(void) 
  2. { 
  3.     sqlite3 *db; 
  4.     char *table_name = "test_table"; 
  5.     char *sql = NULL; 
  6.     int ret, i, j; 
  7.  
  8.     int n_row, n_column, index; 
  9.     char **dbresult; 
  10.     char *errmsg; 
  11.  
  12.     ret = sqlite3_open("./test.db", &db); 
  13.     if(ret != SQLITE_OK) 
  14.     { 
  15.         return -1; 
  16.     } 
  17.  
  18.     sql = sqlite3_mprintf("select * from %s;", table_name); 
  19.  
  20.     ret = sqlite_exec(db, sql, &dbresult, &n_row, &n_column, &errmsg); 
  21.     if(ret != SQLITE_OK) 
  22.     { 
  23.          printf("error:%s\n", errmsg); 
  24.          return -1; 
  25.     } 
  26.  
  27.     index = n_column; 
  28.     printf("查到%d行记录\n", n_row); 
  29.     for(i = 0; i < n_row; i++) 
  30.     { 
  31.         printf("第%d行记录\n", i+1); 
  32.         for(j = 0; j < n_column; j++) 
  33.         { 
  34.             printf("字段名:%s >> 字段值:%s\n", dbresult[j], dbresult[index]); 
  35.             index++; 
  36.         } 
  37.     } 
  38.     sqlite3_free_table(dbresult); 
  39.     sqlite3_free(sql); 
  40.  
  41.     reutrn 0; 
  42. } 
posted @ 2012-12-03 20:21  萝卜先生  阅读(727)  评论(0)  编辑  收藏  举报