文档章节

sqlite讲解二

H
 HillYoung
发布于 2014/02/14 15:50
字数 903
阅读 89
收藏 3

sqlite 编程接口

  • 数据库的打开和关闭 

     

 

    int sqlite3_open(constchar*, sqlite3**);
    int sqlite3_close(sqlite3*);

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

    constchar*sqlite3_errmsg(sqlite3*); 

 

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

    

    int sqlite3_prepare(sqlite3*,constchar*,int, sqlite3_stmt**,

                                                            constchar**);
    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,constchar*,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_*系列函数。

    constunsignedchar*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;
}


本文转载自:http://blog.sina.com.cn/s/blog_726dee1101015uoj.html

H
粉丝 14
博文 99
码字总数 26972
作品 0