iOS开发之SQLite--C语言接口规范(三)——Binding Values To Prepared Statements

  在前面的博客中已经介绍了如何连接SQLite数据库,并且简单的查询和遍历结果集。在前面用到了sqlite3_stmt *stmt,也就是预编译后的SQL语句。在本篇博客中会了解一下sqlite3_stmt,然后了解一下变量的绑定。变量绑定,简单的说就是往预编译后的SQL语句中传入相应的值。

  一. sqlite3_stmt 的生命周期

  这个对象的实例代表着一个被编译成二进制的SQL语句。每个SQL语句都必须经过预编译转换成sqlite3_stmt才能被执行。在iOS开发中,Application或者UIViewController等都是有自己的生命周期的,预编译语句也是有自己的生命周期的,其生命周期如下:

    1.sqlite3_stmt对象的生命起源于sqlite3_prepare_v2(), 使用sqlite3_prepare_v2()可以创建sqlite3_stmt对象。

    2.使用sqlite3_bind_*()接口可以给sqlite3_stmt对象绑定变量。

    3.调用sqlite3_step()一次或者多次来运行SQL语句。

    4.调用sqlite3_reset()回到上一次执行的SQL语句,你可以调用sqlite3_reset()多次,sqlite3_reset()更像版本管理中的回滚操作。

    5.使用sqlite3_finalize()析构函数来释放sqlite3_stmt对象。

  sqlite3_stmt对象的构造函数(推荐使用“v2”接口):sqlite3_prepare()sqlite3_prepare16()sqlite3_prepare16_v2(),sqlite3_prepare_v2()

  sqlite3_stmt对象的析构函数:sqlite3_finalize()

   下方是有关sqlite3_stmt对象的接口,本篇博客主要介绍有关sqlite3_bind_*()的方法。

 

  二、值绑定

    先简单介绍一下什么是值绑定吧。用大白话说,值绑定就是在SQL语句预编译时把一些参数使用占位符(这里是?号)来代替,然后与程序中的变量进行绑定。类似于字符串的格式化。如果你之前搞过Java的JDBC或者PHP, 在他们操作数据库执行SQL语句时都有类似值绑定的一个概念。 就是把外界变量把SQL语句占位的值进行替换。值绑定经常在SELECT,INSERT,UPDATE等语句中进行使用。

    1.为预编译SQL语句绑定变量,绑定不同类型变量需要不同的绑定接口,下方是常用的绑定变量的接口。

            

    2.在sqlite3_prepare_v2()输入的SQL语句的文本中,下面的这些参数将会被替换掉,在下面的参数中,NNN表示一个整数(这个整数就代表这个参数的索引),VVV代表一个字母标示符(参数的名字)。可以使用sqlite3_bind_*()函数为上面的这些占位符进行赋值。

    

    说的直白一些,“?”号就是匿名参数,从第一个问号出现往后的索引默认是1,往后以此类推。而“?NNN”是为匿名参数指定索引,你可以这样写“?1” , "?2"等,而:VVV, @VVV, $VVV这些就是有名参数了,VVV就是参数的名字。比如:ludashi, @ludashi, $ludashi。 

    下面的实例给出了参数不同的几种表现形式, 前一种是匿名参数,后边参数就有自己的名字了。

    3.sqlite3_bind_*()参数介绍(这些绑定函数执行成功后回返回SQLITE_OK, 执行不成功的话回返回相应的错误代码)

      (1) sqlite3_bind_*()的第一个参数是含有上述占位符预编译后的语句指针,也就是sqlite3_stmt的对象。

      (2) sqlite3_bind_*()的第二个参数是SQL语句中参数的索引,例如第一个参数的索引值是1,那么就传1。匿名参数的索引是从1开始往后递增的,而有参数名称的可以通过sqlite3_bind_parameter_index()接口传入参数名称来获取该参数的索引,sqlite3_bind_parameter_index()用法如下,第一个参数是sqlite3_stmt的对象,而后边的参数是SQL参数名称,返回值就是该参数的索引。

int index = sqlite3_bind_parameter_index(statement, "$brandidMin");

      (3) 第三个参数是要绑定的值。

      (4) sqlite3_bind_blob(), sqlite3_bind_text()和sqlite3_bind_text16()这三个接口中还有有第四和第五个参数,第四个参数代表第三个参数“绑定值”的字节长度。第五个参数是一个指向内存管理回调函数的指针。

   4.每个绑定函数的使用场景 

   

    (1) BLOB是数据库中存储大数据的一种数据类型,它是以二进制的形式来存储数据的。

1         SQLITE_API int sqlite3_bind_blob(sqlite3_stmt*, int, const void*, int n, void(*)(void*));    

    (2) 顾名思义,下面的方法是绑定double类型的数据的

1         SQLITE_API int sqlite3_bind_double(sqlite3_stmt*, int, double);   

    (3) 绑定一个32位的整型值

1         SQLITE_API int sqlite3_bind_int(sqlite3_stmt*, int, int);

    (4) 绑定一个64位的整型值

1         SQLITE_API int sqlite3_bind_int64(sqlite3_stmt*, int, sqlite3_int64);

    (5)绑定一个NULL的值(在数据库中可以为NULL)

1         SQLITE_API int sqlite3_bind_null(sqlite3_stmt*, int);

    (6)绑定一个UTF-8编码的字符串,第四个参数上面也提到了,是绑定字符串的长度,如果为负值的话,就是传多少就绑定多少。

1         SQLITE_API int sqlite3_bind_text(sqlite3_stmt*, int, const char*, int n, void(*)(void*));

    (7)绑定一个UTF-16编码的字符串,第四个参数上面也提到了,是绑定字符串的长度,如果为负值的话,就是传多少就绑定多少。

1         SQLITE_API int sqlite3_bind_text16(sqlite3_stmt*, int, const void*, int, void(*)(void*));    

    (8) 绑定sqlite3_value结构体类型的值,sqlite3_value结构体可以保存任意格式的数据。

        SQLITE_API int sqlite3_bind_value(sqlite3_stmt*, int, const sqlite3_value*);    

    (9)绑定一个任意长度的BLOB类型的二进制数据,它的每一个字节被置0。第3个参数是字节长度。这个函数的特殊用处是,创建一个大的BLOB对象,之后可以通过BLOB接口函数进行更新。

1         SQLITE_API int sqlite3_bind_zeroblob(sqlite3_stmt*, int, int n);

  5.值绑定常用工具函数

  (1)下方的函数返回预编译SQL语句中参数的个数,这些参数可以是匿名参数,也可以是有名参数。

    

    具体用法如下:

1     int count = sqlite3_bind_parameter_count(statement);
2     NSLog(@"%d", count);

 

   (2)通过索引获取对应参数的名称

    

    具体用法如下:

1     const char * name = sqlite3_bind_parameter_name(statement, 1);
2     NSLog(@"%s", name);

    (3) 在一个是通过名字获取索引了,正好和上面的方法相反。

    

  调用方式如下:

1         int index = sqlite3_bind_parameter_index(statement, ":brandidMax");
2         NSLog(@":brandidMax——index = %d", index);

  三、值绑定实例

  下面的实例是在查询语句中使用值绑定,绑定完值后,调用查询数据库的方法,然后进行数值的输出,因为上面说的够多了,下面的代码就不用加注释了。

-(void) qureyInfoWithDataBase2: (sqlite3 *) database{

    NSString * qureyInfo = @"SELECT * FROM CARBRAND WHERE BRANDID > :brandidMin AND BRANDID < :brandidMax";

    sqlite3_stmt *statement;

    const char * zSql = [qureyInfo UTF8String];

    int result = sqlite3_prepare_v2(database, zSql, -1, &statement, nil);

    int count = sqlite3_bind_parameter_count(statement);
    NSLog(@"count = %d", count);

    const char * name = sqlite3_bind_parameter_name(statement, 1);
    NSLog(@"name = %s", name);

    if (result == SQLITE_OK) {

        int index = sqlite3_bind_parameter_index(statement, ":brandidMax");
        NSLog(@":brandidMax_index = %d", index);

        //值绑定
        sqlite3_bind_int(statement, 1, 180);
        sqlite3_bind_int(statement, 2, 200);

        [self queryUserInfoWith: database WithStatement: statement];
    }

}

  

  查询数据库的方法

//查询数据库
- (void) queryUserInfoWith: (sqlite3 *) database WithStatement: (sqlite3_stmt *) statement {

    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);

    }
    sqlite3_finalize(statement);

}

  输入结果如下:

    

 今天博客就先到这儿,关于SQLite数据库的东西会继续更新。 

时间: 2024-12-03 22:56:41

iOS开发之SQLite--C语言接口规范(三)——Binding Values To Prepared Statements的相关文章

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

数据库的在上一篇博客中<SQLite之C语言接口规范(三)--Binding Values To Prepared Statements>用到了如何从查询结果中取出结果值.今天的博客就详细的介绍一下sqlite3_column_*()的方法.在SQLite数据库C语言接口中,从查询结果中取出不同类型的值需要不同的接口函数. 一. sqlite3_column_*()介绍 1.下图是sqlite3_column_*()所包含的方法,由下图容易的看出取出不同类型的值需要不同的接口函数.可以取出的类

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

数据库的在上一篇博客中<SQLite之C语言接口规范(三)--Binding Values To Prepared Statements>用到了如何从查询结果中取出结果值.今天的博客就详细的介绍一下sqlite3_column_*()的方法.在SQLite数据库C语言接口中,从查询结果中取出不同类型的值需要不同的接口函数. 一. sqlite3_column_*()介绍 1.下图是sqlite3_column_*()所包含的方法,由下图容易的看出取出不同类型的值需要不同的接口函数.可以取出的类

iOS开发之UITableView与UISearchController实现搜索及上拉加载,下拉刷新实例代码_IOS

废话不多说了,直接给大家贴代码了. 具体代码如下所示: #import "ViewController.h" #import "TuanGouModel.h" #import "TuanGouTableViewCell.h" #define kDeviceWidth [UIScreen mainScreen].bounds.size.width #define kDeviceHeight [UIScreen mainScreen].bounds.

iOS开发之UIKeyboardTypeNumberPad数字键盘自定义按键_IOS

最近做一个搜索用户的功能,这里使用了UISearchBar.由于搜索的方式只有手机号码,所以这里的键盘要限制为数字输入,可以这么做: self.searchBar.keyboardType = UIKeyboardTypeNumberPad;如果使用的不是搜索框而是textField输入框,可以设置textField的键盘属性来展示 self.textField.keyboardType = UIKeyboardTypeNumberPad;监听事件如下所示即可. 但是这里有个问题,就是数字键盘上

iOS开发之SQLite-C语言接口规范(一)——Ready And Open Your SQLite

为什么要搞一搞SQLite的C语言接口规范呢? 因为在做iOS开发中难免会遇到操作数据库的情况,你可以使用第三方的FMDB等,或者使用CoreData.但我们还是有必要去搞清楚如何去使用SQLite的C语言接口来操作SQLite数据库的.从今天开始就给大家结合实例详细的搞一搞SQLite的C语言接口.关于CoreData的东西请看之前的博客<IOS开发之表视图爱上CoreData>. 如果英文好的小伙伴呢,你可以不听我啰嗦,直接官网走起:http://www.sqlite.org 上面的东西是

iOS开发之SQLite-C语言接口规范(二) —— Prepared Your SQL Statements

在<SQLite的C语言接口规范(一)>中介绍了如何去连接打开数据库,本篇博客就介绍如何操作数据库,本篇主要给出了如何执行数据库查询语句(Select), 然后遍历结果集.本篇博客就直接使用上一篇博客封装的打开数据库的方法获取到数据库的操作句柄,然后通过这个句柄来操作我们的Sqlite数据库.今天这篇博客中要多Cars.sqlite数据库中的其中一个表进行Select操作.更为细节的东西请参考SQLite官网:http://www.sqlite.org . 一.预编译SQL语句 要想执行一条查

ios开发之Swift - 点击状态栏使tableView返回顶部(附:状态栏点击事件响应)

1,当页面上只有一个scrollView,点击状态栏scrollView会自动滚动到顶部   比如页面上只有一个表格(UITableView),当点击顶部状态条后,表格会像QQ.微信联系人列表那样回到最上面.   这个是iOS系统默认就有的.   开发之Swift - 点击状态栏使tableView返回顶部(附:状态栏点击事件响应)-swift ios开发教程"> 2,当页面上有多个scrollView,点击状态栏时,视图都不会滚动 这时我们需要把不需要滚动的 scrollView 的 s

ios开发之Swift使用AirPrint进行打印

使用 AirPrint 可以轻松地从 iOS 和 OS X app 中传输无损照片和文稿打印.当然,打印机也要支持AirPrint 技术才行.下面通过样例演示如何在App中使用 Airprint进行打印.    1,打印机模拟器(Printer Simulator)下载 如果没有支持AirPrint的打印机也没关系,苹果提供了个虚拟打印机,地址:https://developer.apple.com/downloads (1)下载里面的 Hardware IO Tools 开发之Swift使用A

ios开发之Swift闭包使用示例

什么是闭包? 闭包是指可以包含自由(未绑定到特定对象)变量的代码块:这些变量不是在这个代码块内或者任何全局上下文中定义的,而是在定义代码块的环境中定义(局部变量). "闭包" 一词来源于以下两者的结合:要执行的代码块(由于自由变量被包含在代码块中,这些自由变量以及它们引用的对象没有被释放)和为自由变量提供绑定的计算环境(作用域). 在Swift中,Swift的闭包跟OC中的Block很像,OC中的Block类似于匿名函数,闭包用来定义函数. 无论是OC中的Block还是Swift中的闭