转载

iOS开发之SQLite--C语言接口规范(四) —— Result Values From A Query

数据库的在上一篇博客中《 SQLite之C语言接口规范(三)——Binding Values To Prepared Statements 》用到了如何从查询结果中取出结果值。今天的博客就详细的介绍一下 sqlite3_column_*() 的方法。在SQLite数据库C语言接口中，从查询结果中取出不同类型的值需要不同的接口函数。

一. sqlite3_column_*()介绍

1.下图是 sqlite3_column_*() 所包含的方法，由下图容易的看出取出不同类型的值需要不同的接口函数。可以取出的类型有blob, bytes, bytes16, double, int, int64, text, text16等。接口的第一个参数是我们预编译的SQL语句（ sqlite3_stmt 的对象），第二个参数是要取出值得行数（从左往右，起始于0）。上面这些接口返回的信息是当前查询行中某列的值。在所有情况下，第一个参数确切的说是指向预编译语句（由 sqlite3_prepare_v2() 函数返回的 sqlite3_stmt * ）的指针。第二个参数是应该返回信息在行中的列索引（结果集的最左边的列索引0）。结果集中的列的数量可以使用 sqlite3_column_count() 来获取。

如果SQL语句目前并不指向一个有效的行或列索引超出了范围内,那么结果集是未定义的。上面这些方法仅仅在调用 sqlite3_step() 函数并且返回 SQLITE_ROW 的情况下调用，不能在 sqlite3_reset() 和 sqlite3_finalize() 执行后调用上述方法。如果你这样做了，结果集将是不确定的。

2. sqlite3_column_count() 具体使用方法如下, 其参数就是 sqlite3_stms * 的预编译语句的指针，返回值就是当前结果集的列数。

//获取查询结果所有的行数     int columnCount = sqlite3_column_count(statement);          NSLog(@"columnCount = %d", columnCount);  //columnCount = 4

3. sqlite3_column_type() 这个函数会返回相应列上数据的类型代码。返回的结果是 SQLITE_INTEGER, SQLITE_FLOAT, SQLITE_TEXT, SQLITE_BLOB 或者 SQLITE_NULL 其中一种情况。在API中对应接口的宏定义如下。

iOS开发之SQLite--C语言接口规范(四) —— Result Values From A Query

sqlite3_column_type ()的调用必须放在 sqlite3_step ()函数执行（并且有结果返回），不然就会返回NULL。使用方式如下：

1         int columnType = sqlite3_column_type(statement, 1); 2          3         NSLog(@"columnType = %d", columnType);  //columnType = 3（SQLITE_TEXT）

4. 如果查询结果的类型是 BLOB 或者 UTF-8 字符串类型，你可以使用 sqlite3_column_bytes ()方法来获取该数据的字节长度。如果结果是UTF-16的字符串， sqlite3_column_bytes ()方法将会把字符串自动转成UTF-8的字符串类型，然后再返回字符串的字节数。 sqlite3_column_bytes16 ()用法是获取UTF-16字符串数值所占字节数的，用法和 sqlite3_column_bytes8 ()相同。这两个方法返回的不是字符串的字符个数，而是字符串所占字节的个数，当然所占字节的个数在这儿不包括C语言中字符串结尾的“/0”。

该函数的具体用法如下：

1         int currentValueBytes = sqlite3_column_bytes(statement, 2); 2          3         NSLog(@"%@字节数为 = %d", firstLetterString, currentValueBytes);

5. sqlite3_column_value () 返回的是一个不受保护的 sqlite3_value 对象。在多线程环境下，一个不受保护的 sqlite3_value 对象，只有被 sqlite3_bind_value () 和 sqlite3_result_value () 接口使用才是安全的。

二、使用实例

在上一篇博客中的查询遍历的方法中进行扩充，扩充后的方法如下：

 1 //查询数据库  2 - (void) queryUserInfoWith: (sqlite3 *) database WithStatement: (sqlite3_stmt *) statement {  3       4     //获取查询结果所有的行数  5     int columnCount = sqlite3_column_count(statement);  6       7     NSLog(@"columnCount = %d", columnCount);  8       9  10      11     while (sqlite3_step(statement) == SQLITE_ROW) { 12          13          14         int rowNum = sqlite3_column_int(statement, 0); 15          16         char *rowDataOne = (char *) sqlite3_column_text(statement, 1); 17          18         char *rowDataTow = (char *) sqlite3_column_text(statement, 2); 19          20         NSString *nameString = [NSString stringWithUTF8String:rowDataOne]; 21          22         NSString *firstLetterString = [NSString stringWithUTF8String:rowDataTow]; 23          24          25         NSLog(@"BrandId = %d, Name = %@, FirstLetter = %@",rowNum , nameString, firstLetterString); 26          27          28          29         int columnType = sqlite3_column_type(statement, 1); 30          31         NSLog(@"/"%@/" 类型代码为 = %d", nameString, columnType);  //columnType = 3（SQLITE_TEXT） 32          33  34          35         int currentValueBytes = sqlite3_column_bytes(statement, 1); 36          37         NSLog(@"/"%@/" 字节数为 = %d /n/n", nameString, currentValueBytes); 38          39     } 40      41     sqlite3_finalize(statement); 42      43 }