Sqlite使用手册

1. 概述

sqlite是一个开源的嵌入式关系数据库，sqlite可移植性好，很容易使用，很小，高效而且可靠，占用资源少。
sqlite嵌入到使用它的应用程序中，它们共用相同的进程空间，而不是单独的一个进程。从外部看，它并不像一个RDBMS，但在进程内部，它却是完整的，自包含的数据库引擎。

嵌入式数据库的一大好处就是在你的程序内部不需要网络配置，也不需要管理。因为客户端和服务器在同一进程空间运行。sqlite 的数据库权限只依赖于文件系统，没有用户帐户的概念。sqlite 有数据库级锁定，没有网络服务器。它需要的内存，其它开销很小，适合用于嵌入式设备。你需要做的仅仅是把它正确的编译到你的程序。

2. 术语

sql语句：用来操作已打开的数据库的操作语句

@H_404_11@3. 常用API使用说明

3.1 所需头文件

#include <sqlite3.h>

3.2 常见API

3.2.1 打开数据库

原型：int sqlite3_open(const char *filename,sqlite3 **ppDb)
功能：打开数据库文件
参数：filename 所要打开的文件名
*ppDb 成功打开文件后用来操作数据库的指针
返回值：sqlITE_OK 表示成功打开文件
其他值表示打开失败

3.2.2 关闭 数据库

原型：int sqlite3_close(sqlite3 * pDb)
功能：打开数据库文件
参数： ppDb 成功打开文件后用来操作数据库的指针
返回值：sqlITE_OK 表示关闭成功
sqlITE_BUSY 表示关闭失败

3.2.3 执行sql语句

原型：int sqlite3_exec(sqlite3* pDb,Const char *sql,int (*callback)(void*,int,char**,char**), Void* arg,char**errmsg)
功能：执行sql语句
参数： pDb 所要操作数据库的指针
sql 要执行的sql语句
Callback 执行语句后调用的回调函数指针
arg 传递给回调函数的第一个参数
errmsg 返回的错误信息
返回值：sqlITE_OK 表示关闭成功
sqlITE_BUSY 表示关闭失败

3.2.4 编译sql语句的声明

原型：int sqlite3_prepare(sqlite3* pDb,const char *zsql,int nByte,sqlite3_stmt **ppStmt,const char **pzTail)
功能：编译要执行sql语句
参数： pDb 所要操作数据库的指针
zsql 要执行的sql语句
nByte sql语句的长度
ppStmt sql语句编译的结果
pzTail 返回的错误信息
返回值：sqlITE_OK 表示关闭成功
sqlITE_BUSY 表示关闭失败

3.2.5 表格行的步进

原型：int sqlite3_step(sqlite3_stmt* pStmt )
功能：使数据库指针指向下一行
参数： pStmt 数据库指针
返回值：sqlITE_ROW 表示该行不为空
其他表示该行为空

3.2.6 获取该行的某列的int型数据

原型：int sqlite3_column_int(sqlite3_stmt* pStmt,int iCol)
功能：获取pStmt所指向的该列的第iCol列int型数据
参数： pStmt 数据库指针
iCol 第几列

3.2.7 获取该行的某列的text型数据

原型： int sqlite3_column_text(sqlite3_stmt* pStmt,int iCol)
功能：获取pStmt所指向的该列的第iCol列text型数据
参数： pStmt 数据库指针
iCol 第几列

3.2.8 获取该行的某列的blob型数据

原型： int sqlite3_column_blob (sqlite3_stmt* pStmt,int iCol)
功能：获取pStmt所指向的该列的第iCol列blob型数据
参数： pStmt 数据库指针
iCol 第几列

3.2.9 获取该行的某列的double型数据

原型：int sqlite3_column_double (sqlite3_stmt* pStmt,int iCol)
功能：获取pStmt所指向的该列的第iCol列double型数据
参数： pStmt 数据库指针
iCol 第几列

3.2.10 释放一个已准备的声明的类

原型： int sqlite3_finalize(sqlite3_stmt *pStmt)
功能：操作完数据库后调用该函数释放使用的空间
参数： pStmt 数据库指针
返回值：sqlITE_OK 表示关闭成功
sqlITE_BUSY 表示关闭失败

4. 使用实例

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

//回调函数
int ListTablesName_callback(void *pDB,int argc,char **argv,char **azColName)
{
    int ret;
    char psqlQuerySel[128] = "select * from ";
    char *pError = NULL;
    sqlite3_stmt *pStmt = NULL;
    strcat(psqlQuerySel,argv[0]); 
    fprintf(stdout,"%s\n",psqlQuerySel);
    //准备读取数据
    ret = sqlite3_prepare((sqlite3 *)pDB,psqlQuerySel,strlen(psqlQuerySel),&pStmt,(const char**)&pError);
    if (ret != sqlITE_OK)
    {
        fprintf(stderr,"sqlite3_prepare fail\n");
        return -1;
    }
    while (1)
    {
        ret = sqlite3_step(pStmt);      //移动记录集
        if (ret != sqlITE_ROW)
            break;

        fprintf(stdout,"%d ",sqlite3_column_int(pStmt,0));
        fprintf(stdout,"%s \n",sqlite3_column_text(pStmt,1));       
    }
    return 0;
}

int main()
{
    int ret = 0;
    sqlite3 *pDB = NULL;
    sqlite3_stmt *pStmt = NULL;
    char *pError = NULL;
    char *pListTablesNameSel = (char*)"SELECT name FROM sqlite_master";//列出所以表名语句
    //打开文件
    ret = sqlite3_open("test.db",&pDB);
    if (ret != sqlITE_OK)
    {
        fprintf(stderr,"can't open database : %s\n",sqlite3_errmsg(pDB));          
        sqlite3_close(pDB);
        return -1;
    }

    //查找源文件中所有表名
    ret = sqlite3_exec(pDB,pListTablesNameSel,ListTablesName_callback,pDB,&pError);
    if (ret != sqlITE_OK)
    {
        fprintf(stderr,"list table count error: %s",sqlite3_errmsg(pDB));          
        sqlite3_close(pDB);
        return -1;
    }

    return 0;
}

编译：g++ example.cpp –lsqlite3
注意：这里需要把sqlite的头文件和库包含在环境变量中

原文链接