SQLite學習手冊(C/C++接口簡介)

一、概述：</strong></span>

    在SQLite提供的C/C++接口中，其中5個APIs屬于核心接口。在這篇博客中我們將主要介紹它們的用法，以及它們所涉及到的核心SQLite對象，如database_connection和prepared_statement。相比于其它數據庫引擎提供的APIs，如OCI、MySQL API等，SQLite提供的接口還是非常易于理解和掌握的。
    
二、核心對象和接口：</strong></span>

    1. 核心對象：
    在SQLite中最主要的兩個對象是，database_connection和prepared_statement。 database_connection對象是由sqlite3_open()接口函數創建并返回的，在應用程序使用任何其他SQLite接口函數之前，必須先調用該函數以便獲得database_connnection對象，在隨后的其他APIs調用中，都需要該對象作為輸入參數以完成相應的工作。至于 prepare_statement，我們可以簡單的將它視為編譯后的SQL語句，因此，所有和SQL語句執行相關的函數也都需要該對象作為輸入參數以完成指定的SQL操作。
    
    2. 核心接口：
    1). sqlite3_open
    上面已經提到過這個函數了，它是操作SQLite數據庫的入口函數。該函數返回的database_connection對象是很多其他SQLite APIs的句柄參數。注意，我們通過該函數既可以打開已經存在的數據庫文件，也可以創建新的數據庫文件。對于該函數返回的 database_connection對象，我們可以在多個線程之間共享該對象的指針，以便完成和數據庫相關的任意操作。然而在多線程情況下，我們更為推薦的使用方式是，為每個線程創建獨立的database_connection對象。對于該函數還有一點也需要額外說明，我們沒有必要為了訪問多個數據庫而創建多個數據庫連接對象，因為通過SQLite自帶的ATTACH命令可以在一個連接中方便的訪問多個數據庫。
        
    2). sqlite3_prepare
    該函數將SQL文本轉換為prepared_statement對象，并在函數執行后返回該對象的指針。事實上，該函數并不會評估參數指定SQL語句，它僅僅是將SQL文本初始化為待執行的狀態。最后需要指出的，對于新的應用程序我們可以使用sqlite3_prepare_v2接口函數來替代該函數以完成相同的工作。
    
    3). sqlite3_step
    該函數用于評估sqlite3_prepare函數返回的prepared_statement對象，在執行完該函數之后，prepared_statement對象的內部指針將指向其返回的結果集的第一行。如果打算進一步迭代其后的數據行，就需要不斷的調用該函數，直到所有的數據行都遍歷完畢。然而對于INSERT、UPDATE和DELETE等DML語句，該函數執行一次即可完成。
    
    4). sqlite3_column
    該函數用于獲取當前行指定列的數據，然而嚴格意義上講，此函數在SQLite的接口函數中并不存在，而是由一組相關的接口函數來完成該功能，其中每個函數都返回不同類型的數據，如：
    sqlite3_column_blob
    sqlite3_column_bytes
    sqlite3_column_bytes16
    sqlite3_column_double
    sqlite3_column_int
    sqlite3_column_int64
    sqlite3_column_text
    sqlite3_column_text16
    sqlite3_column_type
    sqlite3_column_value
    sqlite3_column_count
    其中sqlite3_column_count函數用于獲取當前結果集中的字段數據。下面是使用sqlite3_step和sqlite3_column函數迭代結果集中每行數據的偽代碼，注意這里作為示例代碼簡化了對字段類型的判斷：

int fieldCount = sqlite3_column_count(...);
     while (sqlite3_step(...) <> EOF) {
         for (int i = 0; i < fieldCount; ++i) {
             int v = sqlite3_column_int(...,i);
         }
     }

void test_parameter_binding() {
         //1. 不帶參數綁定的情況下插入多條數據。
         char strSQL[128];
         for (int i = 0; i < MAX_ROWS; ++i) {
             sprintf(strSQL,"insert into testtable values(%d)",i);
             sqlite3_prepare_v2(..., strSQL);
             sqlite3_step(prepared_stmt);
             sqlite3_finalize(prepared_stmt);
         }
         //2. 參數綁定的情況下插入多條數據。
         string strSQLWithParameter = "insert into testtable values(?)";
         sqlite3_prepare_v2(..., strSQL);
         for (int i = 0; i < MAX_ROWS; ++i) {
             sqlite3_bind(...,i);
             sqlite3_step(prepared_stmt);
             sqlite3_reset(prepared_stmt);
         }
         sqlite3_finalize(prepared_stmt);
     }