句柄
要操纵一个数据库你就得有一个这个数据库的句柄(又碰到这个难以理解的词了，不过确实还没得一个更好的词来替代它)。其实你跟本不需要去在乎这个词叫什么，你只要搞清楚他是一个什么玩意儿。就如同鞋子为什么叫鞋子，仔细想想确实也难以理解，不过 清楚他的功能就OK了，不是吗？
句柄在很多地方我们见到过，最常见的就是文件的句柄，我们要操纵一个文件，我们就要取得一个文件的句柄。句柄是个什么东东呢？其实很简单，句柄是一个东东的描述，他被定义为一个结构体，这个结构体可能会包含要描述的东东的具体信息，比如位置、大小、类型等等。我们有了这个描述信息我们就能去找到这个东东，然后操纵它。
一句话：句柄是物体的描述结构体。
我们来看看sqlite的句柄是怎么定义的(不要被吓到了，代码直接跳过就好)：
struct sqlite3 {
sqlite3_vfs *pVfs;
int nDb;
Db *aDb;
int flags;
unsigned int openFlags;
int errCode;
int errMask;
u8 autoCommit;
u8 temp_store;
u8 mallocFailed;
u8 dfltLockMode;
signed char nextAutovac;
u8 suppressErr;
u8 vtabOnConflict;
int nextPagesize;
int nTable;
CollSeq *pDfltColl;
i64 lastRowid;
u32 magic;
int nChange;
int nTotalChange;
sqlite3_mutex *mutex;
int aLimit[SQLITE_N_LIMIT];
struct sqlite3InitInfo {
int iDb;
int newTnum;
u8 busy;
u8 orphanTrigger;
} init;
int nExtension;
void **aExtension;
struct Vdbe *pVdbe;
int activeVdbeCnt;
int writeVdbeCnt;
int vdbeExecCnt;
void (*xTrace)(void*,const char*);
void *pTraceArg;
void (*xProfile)(void*,const char*,u64);
void *pProfileArg;
void *pCommitArg;
int (*xCommitCallback)(void*);
void *pRollbackArg;
void (*xRollbackCallback)(void*);
void *pUpdateArg;
void (*xUpdateCallback)(void*,int, const char*,const char*,sqlite_int64);
#ifndef SQLITE_OMIT_WAL
int (*xWalCallback)(void *, sqlite3 *, const char *, int);
void *pWalArg;
#endif
void(*xCollNeeded)(void*,sqlite3*,int eTextRep,const char*);
void(*xCollNeeded16)(void*,sqlite3*,int eTextRep,const void*);
void *pCollNeededArg;
sqlite3_value *pErr;
char *zErrMsg;
char *zErrMsg16;
union {
volatile int isInterrupted;
double notUsed1;
} u1;
Lookaside lookaside;
#ifndef SQLITE_OMIT_AUTHORIZATION
int (*xAuth)(void*,int,const char*,const char*,const char*,const char*);
void *pAuthArg;
#endif
#ifndef SQLITE_OMIT_PROGRESS_CALLBACK
int (*xProgress)(void *);
void *pProgressArg;
int nProgressOps;
#endif
#ifndef SQLITE_OMIT_VIRTUALTABLE
Hash aModule;
VtabCtx *pVtabCtx;
VTable **aVTrans;
int nVTrans;
VTable *pDisconnect;
#endif
FuncDefHash aFunc;
Hash aCollSeq;
BusyHandler busyHandler;
int busyTimeout;
Db aDbStatic[2];
Savepoint *pSavepoint;
int nSavepoint;
int nStatement;
u8 isTransactionSavepoint;
i64 nDeferredCons;
int *pnBytesFreed;
#ifdef SQLITE_ENABLE_UNLOCK_NOTIFY
sqlite3 *pBlockingConnection;
sqlite3 *pUnlockConnection;
void *pUnlockArg;
void (*xUnlockNotify)(void **, int);
sqlite3 *pNextBlocked;
#endif
};
typedef struct sqlite3 sqlite3;//
是不是被吓到了，没关系，这段代码本来就是我贴出来吓唬你的，我也没认真研究过这个代码，也不想去研究，除非哪天有人出高价请我去研究，我现在只知道怎么用就好了。
这个 sqlite3 结构体就是被用来描述我们磁盘里的数据库文件的，有了这个描述符我们就可以对这个数据库进行各种操作了，操作的具体内情我们不必要了解，我们只需要知道怎么去调用API就好了，当然有时候还是要了解一点点内情的，这个以后碰到再讲。
我用这么长的话加一大段吓人的代码只有一个目的：不要对句柄有恐惧感。
好了，开始我们的正题，sqlite 里面你要操纵数据库我们先得创建一个句柄，然后后面所有对数据库得操作都会用到这个句柄。
sqlite3* pdb;
就 这么简单，这样一个ssqlite的句柄我们就创建完成了，我们以后针对数据库的操作都离不开它了。
打开、关闭、创建 数据库
我创建了一个句柄，但是我怎么知道这个句柄指向的是磁盘上哪个数据库文件呢？我们只是创建了一个指针，指向一个 sqlite3 类型的结构体。里面的数据都是空的或者默认的。我们接下来要做的就是去为这个结构体申请内存并填充这个结构体。是不是感觉又被吓到了？这个结构体这么庞大，我们自己去填充还不的猴年马月啊。一切都不用害怕，并不需要我们显式的去填充它，我们只需要告诉它一些最基本的信息，然后调用API让API去帮我们填充。
目前我们只需要告诉这个结构体一个信息，就是数据库文件的路径。然后调用 sqlite3_open 函数就OK了。
SQLITE_API int sqlite3_open(//SQLITE_API 是个宏，用来标注API的不用理它 const char *zFilename, sqlite3 **ppDb );
第一个参数是路径，const char * 型，第二个参数是数据库句柄的指针，注意是一个二级指针，我们声明的一级指针，所以我们还要加一个取地址符&，请看我下面的实例：
int ret = sqlite3_open( getFilePath(), &pdb);//
不要奇怪，其实打开数据库就是获得数据库的一些信息，然后方便我们操纵它，不是吗？通过这个函数 我们把 数据库与 句柄 pdb 绑定在一起了，我们以就通过 这个 pdb 来操纵数据库了。在这个函数中第一个参数是数据库文件的路径(包括文件名)，我一般会把路径写成一个函数，这样遵循编码原则(这里用到的原则是一个函数尽量只做一件事情)，建议你也这样，好处你自己可以慢慢体会到。我获取路径的函数如下你可以参考一下：
const char* getFilePath(){
return [[NSString stringWithFormat:@"%@/documents/db",NSHomeDirectory() ] UTF8String];
//不好意思这里用到了与IOS相关的一点东西，不过这个也没办法，除非我写成绝对路径，但是那样是行不通的
// 不过也没关系，你移植到别处肯定也是要改路径的咯，所以移植的时候改一下就好了
}
还有一点就是返回值，返回值我们用来判断是否执行成功。sqlite 中帮我们定义了一系列的宏，用来作为返回值：
#define SQLITE_OK 0 #define SQLITE_ERROR 1 #define SQLITE_INTERNAL 2 #define SQLITE_PERM 3 #define SQLITE_ABORT 4 #define SQLITE_BUSY 5 #define SQLITE_LOCKED 6 #define SQLITE_NOMEM 7 #define SQLITE_READonLY 8 #define SQLITE_INTERRUPT 9 #define SQLITE_IOERR 10 #define SQLITE_CORRUPT 11 #define SQLITE_NOTFOUND 12 #define SQLITE_FULL 13 #define SQLITE_CANTOPEN 14 #define SQLITE_PROTOCOL 15 #define SQLITE_EMPTY 16 #define SQLITE_SCHEMA 17 #define SQLITE_TOOBIG 18 #define SQLITE_ConSTRAINT 19 #define SQLITE_MISMATCH 20 #define SQLITE_MISUSE 21 #define SQLITE_NOLFS 22 #define SQLITE_AUTH 23 #define SQLITE_FORMAT 24 #define SQLITE_RANGE 25 #define SQLITE_NOTADB 26 #define SQLITE_ROW 100 #define SQLITE_DONE 101
有了这些我们就可以更加方便地调试我们的代码了。
好了，进入正题，上面这个函数就是在数据库存在的情况下打开数据库，不存在的情况下创建数据库，数据库的名字可以随便乱取，只要是ASCII字符就好了，因为sqlite数据库本来就是一个ASCII文件(所以它的安全性还是不大行的，不过作为本地数据库没啥问题)。
数据库打开后我们就可以进行一系列的增删查改的操作了，操作完毕我们就要关闭数据库，不是么？否则怎么释放资源呢？
关闭也很简单：
SQLITE_API int sqlite3_close(sqlite3 *db);
这个就不用解释了吧，直接看我的实例：
sqlite3_close(pdb);// 这里就可以不去考虑返回值了
