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中了,需要把其拷贝到沙盒中,然后再对其进行增删改查。具体内容详见下篇博客(稍后更新)。

相关文章
|
22天前
|
Java Android开发 Swift
安卓与iOS开发对比:平台选择对项目成功的影响
【10月更文挑战第4天】在移动应用开发的世界中,选择合适的平台是至关重要的。本文将深入探讨安卓和iOS两大主流平台的开发环境、用户基础、市场份额和开发成本等方面的差异,并分析这些差异如何影响项目的最终成果。通过比较这两个平台的优势与挑战,开发者可以更好地决定哪个平台更适合他们的项目需求。
84 1
|
3天前
|
安全 API Swift
探索iOS开发中的Swift语言之美
【10月更文挑战第23天】在数字时代的浪潮中,iOS开发如同一艘航船,而Swift语言则是推动这艘船前进的风帆。本文将带你领略Swift的独特魅力,从语法到设计哲学,再到实际应用案例,我们将一步步深入这个现代编程语言的世界。你将发现,Swift不仅仅是一种编程语言,它是苹果生态系统中的一个创新工具,它让iOS开发变得更加高效、安全和有趣。让我们一起启航,探索Swift的奥秘,感受编程的乐趣。
|
5天前
|
Swift iOS开发 开发者
探索iOS开发中的SwiftUI框架
【10月更文挑战第21天】在苹果生态系统中,SwiftUI的引入无疑为iOS应用开发带来了革命性的变化。本文将通过深入浅出的方式,带领读者了解SwiftUI的基本概念、核心优势以及如何在实际项目中运用这一框架。我们将从一个简单的例子开始,逐步深入到更复杂的应用场景,让初学者能够快速上手,同时也为有经验的开发者提供一些深度使用的技巧和策略。
19 1
|
21天前
|
Android开发 Swift iOS开发
探索安卓与iOS开发的差异:从代码到用户体验
【10月更文挑战第5天】在移动应用开发的广阔天地中,安卓和iOS两大平台各占半壁江山。它们在技术架构、开发环境及用户体验上有着根本的不同。本文通过比较这两种平台的开发过程,揭示背后的设计理念和技术选择如何影响最终产品。我们将深入探讨各自平台的代码示例,理解开发者面临的挑战,以及这些差异如何塑造用户的日常体验。
|
6月前
|
存储 数据库连接 数据库
Android数据存储:解释SQLite数据库在Android中的使用。
Android数据存储:解释SQLite数据库在Android中的使用。
77 0
|
5月前
|
数据库 Android开发 数据安全/隐私保护
在 Android Studio 中结合使用 SQLite 数据库实现简单的注册和登录功能
在 Android Studio 中结合使用 SQLite 数据库实现简单的注册和登录功能
204 2
|
5月前
|
SQL 存储 数据库
48. 【Android教程】数据库:SQLite 的使用
48. 【Android教程】数据库:SQLite 的使用
67 1
|
5月前
|
存储 缓存 数据库
Android之SQLite数据库使用详解
Android之SQLite数据库使用详解
|
5月前
|
存储 数据库 Android开发
在 Android Studio 中结合使用 SQLite 数据库实现简单的注册和登录功能
在 Android Studio 中结合使用 SQLite 数据库实现简单的注册和登录功能
145 0
|
API 数据库 Android开发
Android 中SQLite数据库的使用详解
Android 中SQLite数据库的使用详解
96 0