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()接口使用才是安全的。

  二、使用实例

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

//查询数据库
- (void) queryUserInfoWith: (sqlite3 *) database WithStatement: (sqlite3_stmt *) statement {
 
 //获取查询结果所有的行数
 int columnCount = sqlite3_column_count(statement);
 
 NSLog(@"columnCount = %d", columnCount);
 

 
 while (sqlite3_step(statement) == SQLITE_ROW) {
 
 
 int rowNum = sqlite3_column_int(statement, 0);
 
 char *rowDataOne = (char *) sqlite3_column_text(statement, 1);
 
 char *rowDataTow = (char *) sqlite3_column_text(statement, 2);
 
 NSString *nameString = [NSString stringWithUTF8String:rowDataOne];
 
 NSString *firstLetterString = [NSString stringWithUTF8String:rowDataTow];
 
 
 NSLog(@"BrandId = %d, Name = %@, FirstLetter = %@",rowNum , nameString, firstLetterString);
 
 
 
 int columnType = sqlite3_column_type(statement, 1);
 
 NSLog(@"\"%@\" 类型代码为 = %d", nameString, columnType); //columnType = 3(SQLITE_TEXT)
 

 
 int currentValueBytes = sqlite3_column_bytes(statement, 1);
 
 NSLog(@"\"%@\" 字节数为 = %d \n\n", nameString, currentValueBytes);
 
 }
 
 sqlite3_finalize(statement);
 
}

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

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

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

相关文章
|
19天前
|
C语言 C++
C语言 之 内存函数
C语言 之 内存函数
30 3
|
9天前
|
存储 缓存 C语言
【c语言】简单的算术操作符、输入输出函数
本文介绍了C语言中的算术操作符、赋值操作符、单目操作符以及输入输出函数 `printf` 和 `scanf` 的基本用法。算术操作符包括加、减、乘、除和求余,其中除法和求余运算有特殊规则。赋值操作符用于给变量赋值,并支持复合赋值。单目操作符包括自增自减、正负号和强制类型转换。输入输出函数 `printf` 和 `scanf` 用于格式化输入和输出,支持多种占位符和格式控制。通过示例代码详细解释了这些操作符和函数的使用方法。
30 10
|
3天前
|
存储 算法 程序员
C语言:库函数
C语言的库函数是预定义的函数,用于执行常见的编程任务,如输入输出、字符串处理、数学运算等。使用库函数可以简化编程工作,提高开发效率。C标准库提供了丰富的函数,满足各种需求。
|
8天前
|
机器学习/深度学习 C语言
【c语言】一篇文章搞懂函数递归
本文详细介绍了函数递归的概念、思想及其限制条件,并通过求阶乘、打印整数每一位和求斐波那契数等实例,展示了递归的应用。递归的核心在于将大问题分解为小问题,但需注意递归可能导致效率低下和栈溢出的问题。文章最后总结了递归的优缺点,提醒读者在实际编程中合理使用递归。
32 7
|
8天前
|
存储 编译器 程序员
【c语言】函数
本文介绍了C语言中函数的基本概念,包括库函数和自定义函数的定义、使用及示例。库函数如`printf`和`scanf`,通过包含相应的头文件即可使用。自定义函数需指定返回类型、函数名、形式参数等。文中还探讨了函数的调用、形参与实参的区别、return语句的用法、函数嵌套调用、链式访问以及static关键字对变量和函数的影响,强调了static如何改变变量的生命周期和作用域,以及函数的可见性。
22 4
|
13天前
|
存储 编译器 C语言
C语言函数的定义与函数的声明的区别
C语言中,函数的定义包含函数的实现,即具体执行的代码块;而函数的声明仅描述函数的名称、返回类型和参数列表,用于告知编译器函数的存在,但不包含实现细节。声明通常放在头文件中,定义则在源文件中。
|
19天前
|
C语言
c语言回顾-函数递归(上)
c语言回顾-函数递归(上)
29 2
|
21天前
|
Java 编译器 C语言
【一步一步了解Java系列】:Java中的方法对标C语言中的函数
【一步一步了解Java系列】:Java中的方法对标C语言中的函数
18 3
|
24天前
|
存储 程序员 编译器
C语言——动态内存管理与内存操作函数
C语言——动态内存管理与内存操作函数
|
24天前
|
C语言
C语言字符(串)函数
C语言字符(串)函数