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

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 }

    调用上面的方法,具体的输入结果如下:

  今天的内容就先到这儿,下篇博客回来一个完整的实例,把SQL的增删改查的方法进行封装,对数据库进行操作。下篇博客用到的数据库就不能放到Bundle中了,需要把其拷贝到沙盒中,然后再对其进行增删改查。具体内容详见下篇博客(稍后更新)。

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

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏编程

这或许是对小白最友好的python入门了吧——9,数字深入体验

先给大家介绍一个函数:range(),这个函数是用来干嘛的呢?很简单,数数的,怎么数呢,我先给大家演示一下: for num in range(1,5): ...

2079
来自专栏顶级程序员

MySQL 全文索引应用简明教程

本文从以下几个方面介绍下MySQL全文索引的基础知识: MySQL全文索引的几个注意事项 全文索引的语法 几种搜索类型的简介 几种搜索类型的实例 全文索引的几个...

38310
来自专栏IMWeb前端团队

Redux源码解析系列(四)-- combineReducers

本文作者:IMWeb 黄qiong 原文出处:IMWeb社区 未经同意,禁止转载 combindeReducer 字面意思就是用来合并reducer的...

1937
来自专栏GreenLeaves

EF 约定介绍

当前环境为EF Code First开发模式中 一、EF默认约定 1、常用约定 (1)、当没有显示指定实体主键的时候,EF会默认将长得最像Id的属性(且类型为G...

21210
来自专栏TungHsu

这或许是对小白最友好的python入门了吧——9,数字深入体验

先给大家介绍一个函数:range(),这个函数是用来干嘛的呢?很简单,数数的,怎么数呢,我先给大家演示一下: for num in range(1,5): ...

3818
来自专栏青玉伏案

Oracle常用函数

前一段时间学习Oracle 时做的学习笔记,整理了一下,下面是分享的Oracle常用函数的部分笔记,以后还会分享其他部分的笔记,请大家批评指正。 1.Oracl...

2009
来自专栏GreenLeaves

SQL学习之高级数据过滤

一、高级数据过滤之IN操作符 IN 操作符用来指定条件范围,范围中的每个条件都可以进行匹配。IN取一组由逗号分隔、括在圆括号中的合法值。代码如下: select...

2135
来自专栏冰霜之地

神经病院 Objective-C Runtime 出院第三天——如何正确使用 Runtime

到了今天终于要"出院"了,要总结一下住院几天的收获,谈谈Runtime到底能为我们开发带来些什么好处。当然它也是把双刃剑,使用不当的话,也会成为开发路上的一个大...

982
来自专栏函数式编程语言及工具

FunDA(15)- 示范:任务并行运算 - user task parallel execution

    FunDA的并行运算施用就是对用户自定义函数的并行运算。原理上就是把一个输入流截分成多个输入流并行地输入到一个自定义函数的多个运行实例。这些函数运行实例...

1909
来自专栏JetpropelledSnake

Django学习笔记之Django QuerySet的方法

1205

扫码关注云+社区