SQLiteC/C++接口详细介绍sqlite3_stmt类(二)

返回目录:SQLite—免费开源数据库系列文章目录   

上一篇:SQLiteC/C++接口详细介绍sqlite3_stmt类简介

下一篇:SQLiteC/C++接口详细介绍sqlite3_stmt类(三)

sqlite3_reset()

功能:重置一个准备好执行的SQL语句的状态,使其可以重复执行或进行新的绑定。

在SQLite3准备执行一个SQL语句之前,需要进行一系列的准备工作,包括将SQL语句编译成字节码、执行查询计划等等,这些准备工作都会影响SQL语句的执行效率。如果希望对同一个SQL语句进行多次执行,每次都重新进行这些准备工作是非常浪费时间和资源的,因此我们可以使用sqlite3_reset()函数来重置一个准备好执行的SQL语句的状态,以实现多次执行同一个SQL语句的效果。

sqlite3_reset()函数的原型定义如下:

int sqlite3_reset(sqlite3_stmt *pStmt);

函数的参数是一个sqlite3_stmt类型的指针,它是由sqlite3_prepare_v2()或sqlite3_prepare()等函数返回的sqlite3_stmt类型的准备好的语句。函数返回值为一个整型,表示函数的执行状态,成功则返回SQLITE_OK,否则返回错误代码。

下面是一个使用sqlite3_reset()的简单示例:

#include <sqlite3.h>
#include <stdio.h>
int main() {
    sqlite3 *db;
    sqlite3_stmt *stmt;
    const char *tail;
    char *err_msg = 0;
    sqlite3_open(":memory:", &db);
    sqlite3_prepare_v2(db, "SELECT 1", -1, &stmt, &tail);
    printf("%d\n", sqlite3_step(stmt));  // 输出1
    printf("%d\n", sqlite3_step(stmt));  // 输出101,再次执行SQL语句
    sqlite3_reset(stmt);
    printf("%d\n", sqlite3_step(stmt));  // 再次输出1
    sqlite3_finalize(stmt);
    sqlite3_close(db);
    return 0;
}

以上示例首先使用sqlite3_prepare_v2()函数将SQL语句“SELECT 1”编译成字节码并准备好执行,接着使用sqlite3_step()函数执行SQL语句并输出结果。再次调用sqlite3_step()函数会导致返回101的错误代码,因为SQL语句已经执行完毕且无法再次执行。接下来,使用sqlite3_reset()函数重置SQL语句的状态,使其可以重新执行。最后使用sqlite3_finalize()函数清理sqlite3_stmt对象并关闭数据库连接。

注意:sqlite3_reset()仅重置SQL语句的状态,包括其绑定参数、计数器和游标位置等等,不会清除上一次查询的结果数据,需要使用sqlite3_clear_bindings()函数清除之前的参数绑定。

sqlite3_finalize

使用完sqlite3stmt之后清理预处理语句占用的资源。
sqlite3_finalize函数的声明如下:

int sqlite3_finalize(sqlite3_stmt *pStmt);

sqlite3stmt是一个预处理语句的指针,在使用完sqlite3stmt之后,使用sqlite3finalize来释放占用的资源,返回值为SQLITEOK代表操作成功,SQLITEBUSY代表sqlite3stmt连接正在被其他线程使用,SQLITE_ERROR代表出现其他错误。
sqlite3finalize的作用是结束一个预处理语句的执行,调用该函数会释放sqlite3stmt结构体占用的内存。在使用完sqlite3stmt之后,使用sqlite3finalize进行清理是非常重要的,它可以释放sqlite3stmt连接占用的资源,并且可以检查语法错误等问题,比如程序是否忘记释放sqlite3stmt导致程序内存泄漏等情况。
以下是一个使用sqlite3_finalize的示例:

#include <stdio.h>
#include <sqlite3.h>
int main(void) {
  sqlite3 *db;
  char *zErrMsg = 0;
  int rc;
  const char *sql;
  rc = sqlite3_open(":memory:", &db);
  sql = "CREATE TABLE PERSON(ID INT PRIMARY KEY NOT NULL, NAME TEXT NOT NULL, AGE INT NOT NULL);";
  rc = sqlite3_exec(db, sql, NULL, 0, &zErrMsg);
  if (rc != SQLITE_OK) {
    fprintf(stderr, "SQL error: %s", zErrMsg);
    sqlite3_free(zErrMsg);
  }
  sqlite3_stmt *stmt;

  sql = "INSERT INTO PERSON(ID, NAME, AGE) VALUES(1, 'John', 25);";
  rc = sqlite3_prepare_v2(db, sql, -1, &stmt, NULL);
  if (rc != SQLITE_OK) {
    fprintf(stderr, "SQL error: %s", zErrMsg);
    sqlite3_free(zErrMsg);
  }
  rc = sqlite3_step(stmt);
  if (rc != SQLITE_DONE) {
    fprintf(stderr, "Execution Failed: %s\n", sqlite3_errmsg(db));
  }
  sqlite3_finalize(stmt);
  sqlite3_close(db);
  return 0;
}

以上示例程序首先通过sqlite3open()函数打开一个内存数据库,创建一个名为PERSON的表。接着使用sqlite3preparev2()函数在表中插入一条数据。在数据插入完毕后,使用sqlite3finalize()函数释放sqlite3stmt结构体占用的内存。然后,使用sqlite3close()函数关闭数据库。
可以看到,示例程序使用sqlite3finalize()函数结束sqlite3stmt结构体,以释放内存,并保证我们不会出现内存泄漏的情况。

sqlite3_prepare类

在SQLite3的C语言API中,有多个版本的sqlite3_prepare函数,包括sqlite3_prepare、sqlite3_prepare16、sqlite3_prepare16_v2、sqlite3_prepare16_v3、sqlite3_prepare_v2和sqlite3_prepare_v3函数。它们都被用于编译SQL语句为字节码,为后续的查询执行做准备,并返回准备好的语句的sqlite3_stmt对象的指针。

1、sqlite3_prepare函数
int sqlite3_prepare(
  sqlite3* db,                   /* Database handle */
  const char* zSql,              /* SQL statement, UTF-8 encoded */
  int nByte,                     /* Maximum length of zSql in bytes. */
  sqlite3_stmt** ppStmt,         /* OUT: Statement handle */
  const char** pzTail            /* OUT: Pointer to unused portion of zSql */
);

该函数用于对SQL语句进行编译,生成SQLite的字节码。其中,db是数据库句柄,zSql是要编译的SQL语句,nByte是SQL语句的长度,ppStmt是sqlite3_stmt的指针的指针,它在函数运行成功后将指向一个sqlite3_stmt对象,包含与此SQL语句执行相关的信息,如参数和结果集的列数。pzTail指向SQL语句中未编译的部分的第一个字符的指针。

2. sqlite3_prepare16和sqlite3_prepare16_v2函数
int sqlite3_prepare16(
  sqlite3* db,                   /* Database handle */
  const void* zSql,              /* SQL statement, UTF-16 encoded */
  int nByte,                     /* Maximum length of zSql in bytes. */
  sqlite3_stmt** ppStmt,         /* OUT: Statement handle */
  const void** pzTail            /* OUT: Pointer to unused portion of zSql */
);
int sqlite3_prepare16_v2(
  sqlite3* db,                   /* Database handle */
  const void* zSql,              /* SQL statement, UTF-16 encoded */
  int nByte,                     /* Maximum length of zSql in bytes. */
  sqlite3_stmt** ppStmt,         /* OUT: Statement handle */
  const void** pzTail            /* OUT: Pointer to unused portion of zSql */
  int *pnReserved                /* Reserved for future use */
);

这两个函数与sqlite3_prepare函数类似,用于编译SQL语句,区别在于zSql是UTF-16编码的SQL语句。

3. sqlite3_prepare16_v3函数
int sqlite3_prepare16_v3(
  sqlite3* db,                   /* Database handle */
  const void* zSql,              /* SQL statement, UTF-16 encoded */
  int nByte,                     /* Maximum length of zSql in bytes. */
  unsigned int prepFlags,        /* Zero or more SQLITE_PREPARE_* flags */
  sqlite3_stmt** ppStmt,         /* OUT: Statement handle */
  const void** pzTail            /* OUT: Pointer to unused portion of zSql */
  int *pnReserved                /* Reserved for future use */
);

该函数与sqlite3_prepare16_v2函数类似,不同之处在于多了一个prepFlags参数,这个参数是用于控制编译过程的属性,如 SQLITE_PREPARE_PERSISTENT、SQLITE_PREPARE_NO_VTAB、 SQLITE_PREPARE_DESERIALIZED 等。

4. sqlite3_prepare_v2函数和sqlite3_prepare_v3函数
int sqlite3_prepare_v2(
 sqlite3 *db,             /* Database handle */ 
 const char *zSql,        /* SQL statement, UTF-8 encoded */ 
 int nByte,               /* Maximum length of zSql in bytes. */ 
 sqlite3_stmt **ppStmt,   /* OUT: Statement handle */ 
 const char **pzTail      /* OUT: Pointer to unused portion of zSql */ 
); 
int sqlite3_prepare_v3(
 sqlite3 *db,             /* Database handle */ 
 const char *zSql,        /* SQL statement, UTF-8 encoded */ 
 int nByte,               /* Maximum length of zSql in bytes. */ 
 unsigned int prepFlags,  /* Zero or more SQLITE_PREPARE_* flags */ 
 sqlite3_stmt **ppStmt,   /* OUT: Statement handle */ 
 const char **pzTail      /* OUT: Pointer to unused portion of zSql */ 
);

这两个函数也是用于编译SQL语句,ppStmt参数返回一个sqlite3_stmt结构体指针,pzTail参数类似 sqlite3_prepare16_v3的 pzTail参数,它用于存放未被编译的 SQL 语句字符(UTF-8编码)位置。因为sqlite3_prepare_v2和sqlite3_prepare_v3函数使用UTF-8编码,而sqlite3_prepare、sqlite3_prepare16、sqlite3_prepare16_v2、sqlite3_prepare16_v3函数使用UTF-16编码。

以上是SQLite3 C语言API中的6种预处理函数,它们用于编译SQL语句,生成SQLite的字节码,为后续的查询执行做准备,并返回准备好的语句的sqlite3_stmt对象的指针。其中,选择哪一个预处理函数取决于需求的功能和SQL语句编码格式。

以下是一个使用SQLite3 C语言API中的sqlite3_prepare_v2函数编译SQL语句的示例:

#include <stdio.h>
#include <stdlib.h>
#include <sqlite3.h>
int main(void) {
  sqlite3 *db;
  char *err_msg = 0;
  int rc = sqlite3_open("example.db", &db);
  if (rc != SQLITE_OK) {
    fprintf(stderr, "Cannot open database: %s\n", sqlite3_errmsg(db));
    sqlite3_close(db);
    return 1;
  }
  const char *sql = "SELECT * FROM person";
  sqlite3_stmt *stmt;
  rc = sqlite3_prepare_v2(db, sql, -1, &stmt, NULL);
  if (rc != SQLITE_OK) {
    fprintf(stderr, "Failed to prepare statement: %s\n", sqlite3_errmsg(db));
    sqlite3_close(db);
    return 1;
  }
  while (sqlite3_step(stmt) == SQLITE_ROW) {
    int id = sqlite3_column_int(stmt, 0);
    char *name = (char *)sqlite3_column_text(stmt, 1);
    int age = sqlite3_column_int(stmt, 2);
    printf("ID = %d, NAME = %s, AGE = %d\n", id, name, age);
  }
  sqlite3_finalize(stmt);
  sqlite3_close(db);
  return 0;
}


该示例程序首先使用sqlite3_open()函数打开名为"example.db"的数据库。接着,使用sqlite3_prepare_v2()函数编译一个查询语句,并返回一个sqlite3_stmt对象的指针,包含与此SQL语句执行相关的信息。然后,使用sqlite3_step()函数遍历结果集,使用sqlite3_column_xxx()函数获取结果集中的每一行数据。最后,使用sqlite3_finalize()函数释放sqlite3_stmt结构体占用的内存,并使用sqlite3_close()函数关闭数据库。

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:/a/473938.html

如若内容造成侵权/违法违规/事实不符,请联系我们进行投诉反馈qq邮箱809451989@qq.com,一经查实,立即删除!

相关文章

IDEA之This license XXXX has been suspended

IDEA激活码突然报如下错误: This license XXXXX has been suspended. Please contact your license administrator 解决方案: IDEA版本2022.2.3&#xff0c;亲测管用

【机器学习智能硬件开发全解】(十一)—— 政安晨:通过ARM-Linux掌握基本技能【C语言程序的链接过程】

政安晨的个人主页&#xff1a;政安晨 欢迎 &#x1f44d;点赞✍评论⭐收藏 收录专栏: 机器学习智能硬件开发全解 希望政安晨的博客能够对您有所裨益&#xff0c;如有不足之处&#xff0c;欢迎在评论区提出指正&#xff01; 前言 我们回顾一下上篇文章&#xff1a; 【机器学习…

软件企业在咨询第三方软件测试机构报价时,应提前准备什么资料?

近年来&#xff0c;随着软件行业的迅速发展&#xff0c;软件企业对于软件质量的重视程度日益增加。为了确保软件产品的质量以及用户的满意度&#xff0c;越来越多的企业倾向于委托第三方软件测试机构进行测试工作。在咨询第三方软件测试机构报价之前&#xff0c;软件企业需要提…

SQLiteC/C++接口详细介绍sqlite3_stmt类(四)

返回&#xff1a;SQLite—系列文章目录 上一篇&#xff1a;SQLiteC/C接口详细介绍sqlite3_stmt类&#xff08;三&#xff09; 下一篇&#xff1a;SQLiteC/C接口详细介绍sqlite3_stmt类&#xff08;五&#xff09; 7. sqlite3_bind_parameter_count函数 sqlite3_bind_param…

风速预测(八)VMD-CNN-Transformer预测模型

往期精彩内容&#xff1a; 时序预测&#xff1a;LSTM、ARIMA、Holt-Winters、SARIMA模型的分析与比较-CSDN博客 风速预测&#xff08;一&#xff09;数据集介绍和预处理-CSDN博客 风速预测&#xff08;二&#xff09;基于Pytorch的EMD-LSTM模型-CSDN博客 风速预测&#xff…

【实例】React 组件传值方法: Props、回调函数、Context、路由传参

React原始传值方法 借用状态管理库的传值见下篇文&#xff1a;MobX 和 Redux 【实例】React 状态管理库 MobX Redux 入门及对比 文章目录 React原始传值方法父组件->子组件 props子组件->父组件 回调函数Context路由传值 父组件->子组件 props 父组件可以通过属性&a…

sheng的学习笔记-AI-Inception network

目录&#xff1a;sheng的学习笔记-AI目录-CSDN博客 基础知识 构建卷积层时&#xff0c;你要决定过滤器的大小究竟是11&#xff08;原来是13&#xff0c;猜测为口误&#xff09;&#xff0c;33还是55&#xff0c;或者要不要添加池化层。而Inception网络的作用就是代替你来决定&…

流畅的 Python 第二版(GPT 重译)(一)

前言 计划是这样的&#xff1a;当有人使用你不理解的特性时&#xff0c;直接开枪打死他们。这比学习新东西要容易得多&#xff0c;不久之后&#xff0c;活下来的程序员只会用一个容易理解的、微小的 Python 0.9.6 子集来编写代码 。 Tim Peters&#xff0c;传奇的核心开发者&am…

【数据结构】——线性表(顺序表加链表),万字解读(加链表oj详解)

前言 由于之前存在过对两者的区别考虑&#xff0c;所以把他们放在一起来说&#xff0c;更加容易区别和理解 对于有关线性表的概念这里就不展示了&#xff0c;这里主要是介绍线性表里面的这两个结构的知识点 一.顺序表 1.顺序表介绍 顺序表的存储结构和逻辑结构都是相邻的&a…

前端知识点03(JS)

文章目录 前端知识点03&#xff08;JS&#xff09;1、JS中this指向问题2、script中的async和defer的区别3、setTimeOut和setInterval4、Es6和ES5的区别5、ES6的新特性 &#x1f389;写在最后 前端知识点03&#xff08;JS&#xff09; hello hello~ &#xff0c;这里是 code袁~&…

SpringCloud-Feign远程调用

使用Feign替代RestTemplate进行远程服务调用&#xff1a; 远程调用配置 1. 引入依赖 我们在order-service服务的pom文件中引入feign的依赖&#xff1a; <dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-starte…

spring MVC是如何找到html文件并返回的?

Spring MVC 搜索路径 启动一个SpringBoot项目时&#xff0c;访问http://localhost:8080&#xff0c;对于SpringMVC&#xff0c;它会默认把这段url看成http://localhost:8080/index.html&#xff0c;所以这两个url是等价的。 .html, .css, .js, .img …都是静态资源文件&#x…

玩转C语言——C语言中内存存储

一、 整数在内存中的存储 我们知道&#xff1a;整数的2进制表⽰⽅法有三种&#xff0c;即 原码、反码和补码 三种表⽰⽅法均有符号位和数值位两部分&#xff0c;符号位都是⽤0表⽰“正”&#xff0c;⽤1表⽰“负”&#xff0c;⽽数值位最 ⾼位的⼀位是被当做符号位&#xff0c;…

(学习日记)2024.03.14:UCOSIII第十六节:时间片

写在前面&#xff1a; 由于时间的不足与学习的碎片化&#xff0c;写博客变得有些奢侈。 但是对于记录学习&#xff08;忘了以后能快速复习&#xff09;的渴望一天天变得强烈。 既然如此 不如以天为单位&#xff0c;以时间为顺序&#xff0c;仅仅将博客当做一个知识学习的目录&a…

编曲学习:如何编写钢琴织体 Cubase12逻辑预置 需要弄明白的问题

钢琴织体是指演奏形式、方式,同一个和弦进行可以用很多种不同的演奏方法。常用织体有分解和弦,柱式和弦,琶音织体,混合织体。 在编写钢琴织体前,先定好歌曲的调。 Cubase小技巧:把钢琴轨道向上拖动打和弦轨道,就可以显示和弦!如果你有一些参考工程,不知道用了哪些和…

PG中一个表的3~8个文件是怎么来的?

个人简介 微信公众号&#xff1a;数据库杂记 个人微信: _iihero 我是iihero. 也可以叫我Sean. iiheroCSDN(https://blog.csdn.net/iihero) Sean墨天轮 (https://www.modb.pro/u/16258) iiherozhihu (https://www.zhihu.com/people/zhou-mo-xu) 数据库领域的资深爱好者一枚。…

关于vue3的自定义hook

把一些逻辑写在单独的ts文件里&#xff0c;vue文件使用的时候引入即可 计算属性 1、方法1&#xff1a;return计算属性 直接写出去的话&#xff0c;使用时报错 ExpirationTime是一个计算属性&#xff0c;若直接在html上使用{{ExpirationTime(orderForm)}}报错 查阅资料显示&…

Go --- Go语言垃圾处理

概念 垃圾回收&#xff08;GC-Garbage Collection&#xff09;暂停程序业务逻辑SWT&#xff08;stop the world&#xff09;程序根节点&#xff1a;程序中被直接或间接引用的对象集合&#xff0c;能通过他们找出所有可以被访问到的对象&#xff0c;所以Go程序的根节点通常包括…

UE5的渲染-太难了

大家可以看到&#xff0c;这些都是UE的渲染&#xff0c;非常漂亮惊叹&#xff0c;渲染已经非常成熟&#xff0c;这些画面并不是离线渲染&#xff0c;而是实时渲染。早先年我们渲染CG动画都采用离线渲染&#xff0c;要用到庞大的渲染农场&#xff0c;每渲染一帧都可能需要半个小…

【Maven】使用maven-jar、maven-assembly、maven-shade优雅的实现第三方依赖一同打Jar包

文章目录 一.前言二.常规Jar 打包&#xff1a;maven-jar-plugin三.Shade 打包&#xff1a;maven-shade-plugin1.如何使用2.将部分jar包添加或排除3.将依赖jar包内部资源添加或排除4.自动将所有不使用的类排除5.将依赖的类重命名并打包进来 &#xff08;隔离方案&#xff09;6.修…