初识SQLITE3

 

转自：

http://blog.chinaunix.net/u1/49022/showart_387902.html

 

最近由于工作需要，开始接触开源数据库软件SQLITE。这是毕业后第一次使用数据库编程（以前在学校里都是瞎搞搞）。
    SQLITE是一款非常小巧的嵌入式开源数据库软件，目前最新的版本是3.5.0 alpha版（最新版本可以参考www.sqlite.org ）。它使用一个文件存储整个数据库，操作十分方便。它的最大优点是使用方便，功能相比于其它大型数据库来说，确实有些差距。但是性能表现上，SQLITE并不逊色。

    现在来看它的编程接口，我主要使用的是C语言。由于3.5.0刚出来，可能不稳定，所以我使用的是3.4.2版本。SQLITE提供一种单文件源码包形式
（http://www.sqlite.org/sqlite-amalgamation-3_4_2.zip ），它只包含两个文件:sqlite3.c和sqlite3.h，使用时只需将此两个文件一起编译即可。SQLITE提供的C函数接口在sqlite3.h中都有定义，sqlite的API文档中（http://www.sqlite.org/capi3ref.html ）有详细的描述。刚开始接触sqlite，只学会了最基本的一些数据库操作接口，复杂的东西留待将来慢慢研究。如果你也刚开始接触sqlite的API，可以先看一下http://www.sqlite.org/capi3.html 。

 

    * 数据库的打开和关闭  

    int sqlite3_open(const char*, sqlite3**);
    int sqlite3_close(sqlite3*);
  
    sqlite3为一个结构，它代指一个数据库连接，之后调用的大部分API函数都需要使用它作为其中一个参数。sqlite3_open的第一个参数为文件名字符串。两个函数都是成功返回SQLITE_OK，失败返回错误码。可以使用sqlite3_errmsg函数获得错误描述:

    const char *sqlite3_errmsg(sqlite3*);
 

    * 数据库操作-执行SQL语句

  

    int sqlite3_prepare(sqlite3*, const char*, int, sqlite3_stmt**,const char**);
    int sqlite3_finalize(sqlite3_stmt*);
    int sqlite3_reset(sqlite3_stmt*);

    sqlite3_stmt结构代指一条SQL语句，上述三个函数的功能就是创建、销毁和重置sqlite3_stmt结构。 sqlite3_prepare函数的第二个参数为SQL语句字符串，第三个参数为字符串长度。如果传入的SQL语句字符串超出了一条SQL语句，则第五个参数返回SQL语句字符串中指向下一条SQL语句的char指针。SQL语句字符串可以带?号，它是SQL语句中的不确定部分，需要对它另外赋值。

    int sqlite3_bind_text(sqlite3_stmt*, int, const char*, int n, void(*)(void*));

    sqlite3_bind_*系列函数有好多，这里我只对sqlite3_bind_text进行一下说明，其它的我暂时还没用到。 sqlite3_bind_text的第二个参数为序号（从1开始），第三个参数为字符串值，第四个参数为字符串长度。 sqlite3_bind_text的第五个参数为一个函数指针，SQLITE3执行完操作后回调此函数，通常用于释放字符串占用的内存。（这个函数指针参数具体怎么使用，我现在还不清楚）。此参数有两个常数，SQLITE_STATIC告诉sqlite3_bind_text函数字符串为常量，可以放心使用；而SQLITE_TRANSIENT会使得sqlite3_bind_text函数对字符串做一份拷贝。一般使用这两个常量参数来调用 sqlite3_bind_text。
    statement准备好了以后，就是操作的执行了。

    int sqlite3_step(sqlite3_stmt*);
  
    它的返回值相对有些特殊。返回SQLITE_BUSY表示暂时无法执行操作，SQLITE_DONE表示操作执行完毕，SQLITE_ROW表示执行完毕并且有返回（执行select语句时）。当返回值为SQLITE_ROW时，我们需要对查询结果进行处理，SQLITE3提供 sqlite3_column_*系列函数。

    const unsigned char *sqlite3_column_text(sqlite3_stmt*, int iCol);

    其中参数iCol为列的序号，从0开始。如果返回值有多行，则可以再次调用sqlite3_step函数，然后由sqlite3_column_*函数取得返回值。


    使用上述这些函数基本上可以完成对SQLITE3数据库的操作了（不过我这里只针对text数据类型做了说明）。当然，sqlite3还有很多其它的接口函数，以后再慢慢摸索吧，现在只是刚开始。

    下面是一段示例代码：

 

 

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


int main(){
    sqlite3 *db;
    char *zErrMsg = NULL;
    int rv;
    char szSql[128] = { 0 };
    sqlite3_stmt *stmt;

    rv = sqlite3_open("test.db", &db);
    if( rv ){
        fprintf(stderr, "Can't open database: %s\n", sqlite3_errmsg(db));
        sqlite3_close(db);
        return 1;
      }
     else
        fprintf(stderr, "sqlite3_open OK\n");

    //这里查询时，假定数据库中存在表test，并且有一列为COL1(text类型)

    strcpy(szSql, "SELECT COL1 FROM test where COL1=?");
    rv = sqlite3_prepare(db, szSql, 128, &stmt, NULL);
    if( rv != SQLITE_OK ) {
        fprintf(stderr, "sqlite3_prepare(%d): %s\n", rv, sqlite3_errmsg(db));
        return -1;
    }
   
    rv = sqlite3_bind_text(stmt, 1, "VALUE1", strlen("VALUE1"), SQLITE_STATIC);
    if( rv != SQLITE_OK ) {
        fprintf(stderr, "sqlite3_bind_text(%d): %s\n", rv, sqlite3_errmsg(db));
        return -1;
    }

    rv = sqlite3_step(stmt);
    if( (rv != SQLITE_OK) && (rv != SQLITE_DONE) && (rv != SQLITE_ROW) ) {
        fprintf(stderr, "sqlite3_step(%d): %s\n", rv, sqlite3_errmsg(db));
        return -1;
    }


    while( rv == SQLITE_ROW ){
        fprintf(stderr, "result: %s\n", sqlite3_column_text(stmt,0));
        rv = sqlite3_step(stmt);
    }   


    rv = sqlite3_finalize(stmt);
    if( rv != SQLITE_OK ) {
        fprintf(stderr, "sqlite3_finalize(%d): %s\n", rv, sqlite3_errmsg(db));
        return -1;
    }


    sqlite3_close(db);
    return 0;
}