sqlite 第三版C/C++接口
1.0 概述
sqlite 3.0是sqlite的新版本，它继承于sqlite 2.8.13，但带有一个不兼容的文件格式和API。sqlite 3.0依据以下需求而创建：
必须迁移到3.0版来实现的原因是每一个改变与数据库文件格式不兼容。另外一些不兼容的改变，如清除的API，在下面的理论中介绍最好是一次性去掉你的不兼容的变化。
3.0版的API与2.X版的相似，但也有一些重要的改变。最显著的是出现在所有的API函数和数据据结构前的“sqlite_”前缀被改为“sqlite3_”。这避免二类API间的混乱并且允许链接器同时应对sqlite 2.X和sqlite 3.0。
在UTF-16的C类型应该是什么样子上没有统一。因此，sqlite用一个通用的类型void *来指向UTF-16字符串。客户软件可以转换void*到任何与之系统相适应的数据类型。
2.0 C/C++接口
除了几个数据结构和#define，sqlite 3.0的API包括了83个独立的函数。（一个完整的API参考作为一个独立的文档提供。）幸运的是，接口不是与它所显示的大小一般复杂。简单的程序仍可以通过仅仅三个函数工作：sqlite3_open()、sqlite3_exec()和sqlite3_close()。更多的数据库引擎运行控制可以用sqlite3_prepare()来编译一个sqlite语句成字节代码并通过sqlite3_step()来执行它。一个用sqlite3_column_开头的命令序列可以用来提取关于查询结果的信息。许多接口函数是以UTF-8和UTF-16的形式成对出现的。并且有一个用于实现用户定义sql函数和用户定义的text比较。
typedef struct sqlite3 sqlite3;
int sqlite3_open(const char*,sqlite3**);
int sqlite3_open16(const void*,sqlite3**);
int sqlite3_close(sqlite3*);
const char *sqlite3_errmsg(sqlite3*);
const void *sqlite3_errmsg16(sqlite3*);
int sqlite3_errcode(sqlite3*);
sqlite3_open()程序返回一个整型错误代码，而不是像sqlite2做的那样返回一个指向sqlite3结构。sqlite3_open()与sqlite3_open16()间的区别是sqlite3_open16()采用UTF-16（以本地字节顺序）作为数据库文件名。如果一个新数据库文件需要被创建，那么sqlite3_open16()设置本地的文本表达式为UTF-16而sqlite3_open()设置文本表达式为UTF-8。
数据库文件打开与创建延迟到用户实际的时候（被打开或创建）。这允许可选项和参数，如本地文本表示和默认的页大小，通过用PRAGMA语句设置。
sqlite3_errcode()指令返回一个最近的主API调用的结果代码。sqlite3_errmsg()返回一个最近错误的英文信息。错误码信息可能是暂时的 - 它可能在接下来的任何sqlite函数调用时消失。sqlite3_errmsg16()象sqlite3_errsmg()一样工作，除了它以本地字节顺序返回一个UTF-16错误信息。
sqlite 3 的错误代码与版本2相比并没有变化。它们如下所示
- #define sqlITE_OK 0 /* 成功的结果 */
- #define sqlITE_ERROR 1 /* sql 错误或没有数据库 */
- #define sqlITE_INTERNAL 2 /* 一个sqlite内部的逻辑错误 */
- #define sqlITE_PERM 3 /* 存取许可被拒绝 */
- #define sqlITE_ABORT 4 /* 需要一个中断的Callback指令 */
- #define sqlITE_BUSY 5 /* 数据据库文件被锁定 */
- #define sqlITE_LOCKED 6 /* 数据库中的一个表被锁定 */
- #define sqlITE_NOMEM 7 /* malloc()失败 */
- #define sqlITE_READONLY 8 /* 试图写一个只读的数据库 */
- #define sqlITE_INTERRUPT 9 /* 操作被sqlite_interrupt()结束 */
- #define sqlITE_IOERR 10 /* 某种磁盘I/O错误发生 */
- #define sqlITE_CORRUPT 11 /* 数据库磁盘镜像异常 */
- #define sqlITE_NOTFOUND 12 /* (Internal Only) 表或记录不存在 */
- #define sqlITE_FULL 13 /* 数据库满插入失败 */
- #define sqlITE_CANTOPEN 14 /* 不能打开数据库文件 */
- #define sqlITE_PROTOCOL 15 /* 数据库错定协议错 */
- #define sqlITE_EMPTY 16 /* (Internal Only)数据库表为空 */
- #define sqlITE_SCHEMA 17 /* 数据库结构被改变 */
- #define sqlITE_TOOBIG 18 /* 一个表的行数据过多 */
- #define sqlITE_CONSTRAINT 19 /* 由于约束冲突而中止 */
- #define sqlITE_MISMATCH 20 /* 数据类型不匹配 */
- #define sqlITE_MISUSE 21 /* 库被不正确使用 */
- #define sqlITE_NOLFS 22 /* 主机不支持的OS特性 */
- #define sqlITE_AUTH 23 /* 授权被否定 */
- #define sqlITE_ROW 100 /* sqlite_step()有另一行就绪 */
- #define sqlITE_DONE 101 /* sqlite_step()已经完成执行 */
- 2.2 执行sql语句
- typedef int (*sqlite_callback)(void*,int,char**,char**);
- int sqlite3_exec(sqlite3*,const char *sql,sqlite_callback,void*,char**);
- typedef struct sqlite3_stmt sqlite3_stmt;
- int sqlite3_prepare(sqlite3*,const char*,sqlite3_stmt**,const char**);
- int sqlite3_prepare16(sqlite3*,const void*,const void**);
- int sqlite3_finalize(sqlite3_stmt*);
- int sqlite3_reset(sqlite3_stmt*);
- int sqlite3_bind_blob(sqlite3_stmt*,int n,void(*)(void*));
- int sqlite3_bind_double(sqlite3_stmt*,double);
- int sqlite3_bind_int(sqlite3_stmt*,int);
- int sqlite3_bind_int64(sqlite3_stmt*,long long int);
- int sqlite3_bind_null(sqlite3_stmt*,int);
- int sqlite3_bind_text(sqlite3_stmt*,void(*)(void*));
- int sqlite3_bind_text16(sqlite3_stmt*,void(*)(void*));
- int sqlite3_bind_value(sqlite3_stmt*,const sqlite3_value*);
- 一个sql语句准备好之后（可选界定），它以用下面语句执行：
2.3 用户定义函数2.4用户定义排序
