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);       }