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 *的预编译语句的指针, 返回值就是当前结果集的列数。

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

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

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

该函数的具体用法如下:

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

二、使用实例

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

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

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

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

打赏支持我写出更多好文章,谢谢!

打赏作者

打赏支持我写出更多好文章,谢谢!

1 1 收藏 评论

关于作者:青玉伏案

乐于分享,广交善缘。走在技术的路上,一直在学习中。(http://www.cnblogs.com/ludashi/)https://github.com/lizeluQQ群:310800319 个人主页 · 我的文章 · 3 ·    

相关文章

可能感兴趣的话题



直接登录
跳到底部
返回顶部