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

发表于 由admin

　　数据库的在上一篇博客中《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()来获取。

　　　　sqlite 1

　　　　若是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中对应接口的宏定义如下。

sqlite 2

　　　　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 }

 

　　　　调用上边的法子，具体的输入结果如下：

　　　　sqlite 3

　　明天的内容就先到那时候，下篇博客回来一个完好的实例，把SQL的增删改查的艺术开展打包，对数据库进行操作。下篇博客用到的数据库就不可能松开Bundle中了，要求把其拷贝到沙盒中，然后再对其进行增删改查。具体内容详见下篇博客（稍后更新）。

　　本篇博客中使用的数据库资源GitHub分享地址：https://github.com/lizelu/SQLiteResource

网站地图xml地图