Linux C SQLite3 编程

SQLite3
SQLite是一个轻量级的数据库。和常用的MySQL大同小异。和MySQL相比，数据类型基本一样，只是sqlite的指令都是以"."开头（如：mysql中查看当前有哪些数据库是“show databases"，而sqlite中是".databases"）。当然，SQL语句都是一样的语法规则。
Host System: Archlinux  
gcc: 4.6.1 20110819
sqlite3: 3.7.8 20110919
系统一般没有默认安装sqlite数据库，所以先要安装sqlite3：
# pacman -S sqlite3
可以使用"sqlite3 + 数据库名"来打开一个数据库。

常用函数

sqlite3_open(const char *filename, sqlite3 **ppDb);
sqlite3_close(sqlite3 *db);
sqlite3_exec(sqlite3*, const char *sql, int (*callback)(void*,int,char**,char**), void *, char **errmsg);
这三个函数基本上能完成对sqlite3的所有操作。需要用的头文件为"sqlite3.h"。
打开（新建）数据库
sqlite3 *db;  
sqlite3_open("test.db", &db);
关闭数据库
sqlite3_close(db);  
执行sql语句(以创建表为例)
char sql[128];  
memset(sql, '\0', 128);
sprintf(sql, "%s%s%s", "create table "， "test_tb", "(id INTEGER PRIMARY KEY, data TEXT)");
sqlite3_exec(db, sql, NULL, NULL, NULL);
sqlite3_exec中第一个和第二个参数的意义很好理解。第三个参数是一个回调(callback)函数。第四个参数可用于给回调函数传入一个参数。第五个参数为这条sql语句执行后的返回。我试了好几次，第五个参数的返回值打印出来都是乱码，所以建议直接查看sqlite3_exec函数的返回指，它返回一个整型的数，可以通过这个数字来得知的执行结果。

下面给个例子来看回调函数是怎么执行的：查询数据库中的一张表，并把表中的内容写到文件中。

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

/* callback函数中： 
 * arg: 是从主函数传进来的参数 
 * values: 是查询结果的值 
 * names: 查询结果列的名字 
 */ 
int wf_callback(void *arg, int nr, char **values, char **names) 
{ 
    int i; 
    FILE *fd; 
    char str[128]; 
    fd = (FILE *)arg; //将void *的参数强制转换为FILE * 
    for (i=0; i<nr; i++) { //将查询结果写入到文件中 
        memset(str, '\0', 128); 
        sprintf(str, "\t%s\t", values[i]); 
        fwrite(str, sizeof(char), sizeof(str), fd); 
    } 
    memset(str, '\0', 128); 
    fwrite("\n", sizeof(char), 2, fd); //写完一条记录换行 
    return 0; //callback函数正常返回0 
} 


int main() 
{ 
    char sql[128]; 
    sqlite3 *db; 
    FILE *fd; 

    sqlite3_open("test.db", &db); //打开（或新建）一个数据库 
    memset(sql, '\0', 128); 
    /* 新建一张表 */ 
    strcpy(sql, "create table tb(id INTEGER PRIMARY KEY, data TEXT)"); 
    sqlite3_exec(db, sql, NULL, NULL, NULL); 

    /* 新建一个文件，把数据库的查询结果保存在该文件中 */ 
    fd = fopen("test", "w"); 
    fwrite("Result: \n", sizeof(char), 10, fd); 
    memset(sql, '\0', 128); 
    strcpy(sql, "select * from tb"); 
    sqlite3_exec(db, sql, wf_callback, fd, NULL); 
    fclose(fd); 

    sqlite3_close(db); //关闭数据库 
    return 0; 
} 

 

我们关注这里的回调函数wf_callback()。sqlite3_exec()函数先执行sql语句，如果sql语句的执行结果不为空，则调用回调函数进行处理。test文件中有3行数据，所以wf_callback()函数被调用了三次（这里我们也可以在回调函数中添加一个全局变量来计数，以查看回调函数是否多次被调用）。因为回调函数会被多次调用，所以这里在main函数中打开文件，把文件描述符以参数的形式传递给回调函数；否则，将fopen和fclose写到回调函数中，每调用一次回调函数，回调函数都会以“w”去打开文件，第二次调用回调函数的结果会覆盖第一调用回调函数的结果，使写入文件的内容不正确（只会在文件中写入最后一条记录）。
如果在查询语句中调用了SQL中的一些函数，如sum()等，也可以同样用回调函数来处理查询结果，如：
strcpy(sql, "select sum(id) from tb");
sqlite3_exec(db, sql, sum_callback, NULL, NULL);
则回调函数可以为：

int result; 
int sum_callback(void *arg, int nr, char **values, char **names) 
{ 
    result = atoi(values[0]); 
    return 0; 
} 

然后再对result进行处理。当然，也可以不定义这个全局变量，而直接在回调函数里对result进行处理。需要注意的是，查询结果均为字符数组形式的，所以如果需要的结果是int型或者float型，则需要相应的函数来转换，如atoi()，atof()等。

原文地址：http://www.linuxidc.com/Linux/2011-10/45920.htm