聲明 歡迎轉載,但是請尊重作者勞動成果,轉載請保留此框內聲明,謝謝。 文章出處:http://blog.csdn.net/iukey |
上一講的最後我留了點懸念,不知道上一講看完你有木有疑問。我的疑問就是我建立了一個控制代碼,但是我怎麼知道這個控制代碼指向的是磁碟上哪個資料庫檔案呢?我們只是建立了一個指標,指向一個 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 /* Successful result *//* beginning-of-error-codes */#define SQLITE_ERROR 1 /* SQL error or missing database */#define SQLITE_INTERNAL 2 /* Internal logic error in SQLite */#define SQLITE_PERM 3 /* Access permission denied */#define SQLITE_ABORT 4 /* Callback routine requested an abort */#define SQLITE_BUSY 5 /* The database file is locked */#define SQLITE_LOCKED 6 /* A table in the database is locked */#define SQLITE_NOMEM 7 /* A malloc() failed */#define SQLITE_READONLY 8 /* Attempt to write a readonly database */#define SQLITE_INTERRUPT 9 /* Operation terminated by sqlite3_interrupt()*/#define SQLITE_IOERR 10 /* Some kind of disk I/O error occurred */#define SQLITE_CORRUPT 11 /* The database disk image is malformed */#define SQLITE_NOTFOUND 12 /* Unknown opcode in sqlite3_file_control() */#define SQLITE_FULL 13 /* Insertion failed because database is full */#define SQLITE_CANTOPEN 14 /* Unable to open the database file */#define SQLITE_PROTOCOL 15 /* Database lock protocol error */#define SQLITE_EMPTY 16 /* Database is empty */#define SQLITE_SCHEMA 17 /* The database schema changed */#define SQLITE_TOOBIG 18 /* String or BLOB exceeds size limit */#define SQLITE_CONSTRAINT 19 /* Abort due to constraint violation */#define SQLITE_MISMATCH 20 /* Data type mismatch */#define SQLITE_MISUSE 21 /* Library used incorrectly */#define SQLITE_NOLFS 22 /* Uses OS features not supported on host */#define SQLITE_AUTH 23 /* Authorization denied */#define SQLITE_FORMAT 24 /* Auxiliary database format error */#define SQLITE_RANGE 25 /* 2nd parameter to sqlite3_bind out of range */#define SQLITE_NOTADB 26 /* File opened that is not a database file */#define SQLITE_ROW 100 /* sqlite3_step() has another row ready */#define SQLITE_DONE 101 /* sqlite3_step() has finished executing *//* end-of-error-codes */
有了這些我們就可以更加方便地調試我們的代碼了。
好了,進入正題,上面這個函數就是在資料庫存在的情況下開啟資料庫,不存在的情況下建立資料庫,資料庫的名字可以隨便亂取,只要是ASCII字元就好了,因為sqlite資料庫本來就是一個ASCII檔案(所以它的安全性還是不大行的,不過作為本機資料庫沒啥問題)。
資料庫開啟後我們就可以進行一系列的增刪查改的操作了,操作完畢我們就要關閉資料庫,不是嗎?否則怎麼釋放資源呢?
關閉也很簡單:
SQLITE_API int sqlite3_close(sqlite3 *db);
這個就不用解釋了吧,直接看我的執行個體:
sqlite3_close(pdb);// 這裡就可以不去考慮傳回值了
好了,這一節又講完了。是不是覺得很簡單。OK,期待下一節吧,下一節我們學習:建立表。