SQLiteC/C++接口详细介绍之sqlite3类(十六)

2024-03-16 19:12

本文主要是介绍SQLiteC/C++接口详细介绍之sqlite3类(十六),希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

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

上一篇:SQLiteC/C++接口详细介绍之sqlite3类(十五)

下一篇: SQLiteC/C++接口详细介绍之sqlite3类(十七)(未发表)

 50.sqlite3_system_errno

函数功能:获取最近一次系统(操作系统)调用发生错误时的错误号(errno)。该函数在SQLite发生系统调用错误时非常有用,可以用于诊断操作系统应该依据errno提供的详细信息进一步解释该错误的根本原因。

函数原型如下:

int sqlite3_system_errno(sqlite3*);

- 参数为指向sqlite3结构体的指针。
- 返回最近一次系统调用发生错误时的错误号(errno)。

下面是一个简单的示例,在代码中我们利用文件不存在这个错误,进行案例的演示:

#include <sqlite3.h>
#include <stdio.h>
#include <errno.h>
int main() {sqlite3 *db;sqlite3_open(":memory:", &db);sqlite3_exec(db, "CREATE TABLE test (id INTEGER PRIMARY KEY, value TEXT)", NULL, NULL, NULL);int ret = sqlite3_exec(db, "SELECT * FROM non_existing_table", NULL, NULL, NULL);if (ret != SQLITE_OK) {printf("SQLite error: %s\n", sqlite3_errmsg(db));printf("System error: %d\n", sqlite3_system_errno(db));printf("System error message: %s\n", strerror(sqlite3_system_errno(db)));}sqlite3_close(db);return 0;
}

该示例中我们在执行一个不存在的表的查询语句时,会导致SQLITE_ERROR的出现。可以利用sqlite3_system_errno()函数获取系统错误号,并使用strerror()函数将该错误号转换为可读的错误消息。输出结果中会包含errno所对应的错误消息。

如果运行该示例,将会输出如下信息:

SQLite error: no such table: non_existing_table
System error: 2
System error message: No such file or directory

可以看到,该示例中由于执行了一个不存在的表查询语句,会导致系统错误号为2(ENOENT),表示找不到指定的文件或目录。

51.sqlite3_table_column_metadata

功能:获取表中某一列的信息,包括列类型、是否为主键等信息。

函数的原型如下:

int sqlite3_table_column_metadata(sqlite3 *db,               /* 数据库连接 */const char *zDbName,       /* 数据库名称,空表示当前数据库 */const char *zTableName,    /* 表名称 */const char *zColumnName,   /* 列名称,如果空则返回所有列 */char const **pzDataType,   /* 返回数据类型 */char const **pzCollSeq,    /* 返回排序规则的名称 */int *pNotNull,             /* 返回是否是NOT NULL的标志 */int *pPrimaryKey,          /* 返回是否是主键的标志 */int *pAutoinc              /* 返回是否是自增列的标志 */
);

各个参数的含义如下:

- db:数据库连接句柄。
- zDbName:表所在的数据库的名称,为NULL表示当前连接的数据库。
- zTableName:表的名称。
- zColumnName:列的名称,可以为一个空指针,如果为NULL,则将返回指定表的所有列的信息。
- pzDataType:如果不为NULL,将得到列的类型信息的指针。
- pzCollSeq:如果不为NULL,则得到列的排序规则名称。
- pNotNull:如果不为NULL,则得到非空列的标志,如果列为非空,则为1,否则为0。
- pPrimaryKey:如果不为NULL,则得到主键的标志。如果列是主键,则为1,否则为0。
- pAutoinc:如果不为NULL,则得到列是否为自增的标志。如果列为自增长,则为1,否则为0。

下面是一个示例:

#include <sqlite3.h>
#include <stdio.h>
int main() {sqlite3 *db;sqlite3_open(":memory:", &db);sqlite3_exec(db, "CREATE TABLE test (id INTEGER PRIMARY KEY AUTOINCREMENT, value TEXT NOT NULL)", NULL, NULL, NULL);const char *dataType;const char *collSeq;int notNull;int primaryKey;int autoinc;sqlite3_table_column_metadata(db, NULL, "test", "id", &dataType, &collSeq, &notNull, &primaryKey, &autoinc);printf("id info:\ndataType=%s\ncollSeq=%s\nnotNull=%d\nprimaryKey=%d\nautoinc=%d\n", dataType, collSeq, notNull, primaryKey, autoinc);sqlite3_table_column_metadata(db, NULL, "test", "value", &dataType, &collSeq, &notNull, &primaryKey, &autoinc);printf("value info:\ndataType=%s\ncollSeq=%s\nnotNull=%d\nprimaryKey=%d\nautoinc=%d\n", dataType, collSeq, notNull, primaryKey, autoinc);sqlite3_close(db);return 0;
}

该示例中我们创建了一张包含两个列的表,其中id列为主键、INT类型、自增,value列为TEXT类型、非空。

在程序中我们使用sqlite3_table_column_metadata()函数获取id列和value列的相关信息,这些信息分别包括:数据类型、排序规则、是否为非空列、是否为主键、是否为自增列值。

输出结果如下:

id info:
dataType=INTEGER
collSeq=BINARY
notNull=0
primaryKey=1
autoinc=1
value info:
dataType=TEXT
collSeq=BINARY
notNull=1
primaryKey=0
autoinc=0

我们可以看到,id列是主键、INT类型、自增,而value列是TEXT类型、非空。

52.sqlite3_total_changes与sqlite3_total_changes64

函数功能:获取自数据库连接打开以来所做的修改总数,即INSERT、UPDATE和DELETE所影响的总行数。两个函数的主要区别在于,sqlite3_total_changes返回一个int类型的值,而sqlite3_total_changes64返回一个int64类型的值。

函数的原型如下:

int sqlite3_total_changes(sqlite3*);
sqlite3_int64 sqlite3_total_changes64(sqlite3*);

参数是一个指向sqlite3结构体的指针,返回值是一个表示自连接建立以来所做的修改次数的整数值(或64位整数值)。

下面是一个示例,展示如何计算自打开数据库以来所做的更改总数:

#include <sqlite3.h>
#include <stdio.h>
int main() {sqlite3 *db;sqlite3_open(":memory:", &db);sqlite3_exec(db, "CREATE TABLE test (id INTEGER PRIMARY KEY, value TEXT)", NULL, NULL, NULL);sqlite3_exec(db, "INSERT INTO test (id, value) VALUES (1, 'hello')", NULL, NULL, NULL);sqlite3_exec(db, "UPDATE test SET value = 'world' WHERE id = 1", NULL, NULL, NULL);sqlite3_exec(db, "DELETE FROM test WHERE id = 1", NULL, NULL, NULL);int changes = sqlite3_total_changes(db);printf("Total changes: %d\n", changes);sqlite3_int64 changes64 = sqlite3_total_changes64(db);printf("Total changes (int64): %lld\n", changes64);sqlite3_close(db);return 0;
}

在该示例中,我们创建了一个test表,并进行了一些INSERT、UPDATE和DELETE操作。然后我们使用sqlite3_total_changes()和sqlite3_total_changes64()函数获取自打开数据库以来所做的更改总数。输出结果如下:

Total changes: 3
Total changes (int64): 3
可以看到,该示例中自打开数据库以来所做的更改总数为3条记录。

这篇关于SQLiteC/C++接口详细介绍之sqlite3类(十六)的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/816432

相关文章

Python FastMCP构建MCP服务端与客户端的详细步骤

《PythonFastMCP构建MCP服务端与客户端的详细步骤》MCP(Multi-ClientProtocol)是一种用于构建可扩展服务的通信协议框架,本文将使用FastMCP搭建一个支持St... 目录简介环境准备服务端实现(server.py)客户端实现(client.py)运行效果扩展方向常见问题结

Spring Boot 整合 Apache Flink 的详细过程

《SpringBoot整合ApacheFlink的详细过程》ApacheFlink是一个高性能的分布式流处理框架,而SpringBoot提供了快速构建企业级应用的能力,下面给大家介绍Spri... 目录Spring Boot 整合 Apache Flink 教程一、背景与目标二、环境准备三、创建项目 & 添

Java进程CPU使用率过高排查步骤详细讲解

《Java进程CPU使用率过高排查步骤详细讲解》:本文主要介绍Java进程CPU使用率过高排查的相关资料,针对Java进程CPU使用率高的问题,我们可以遵循以下步骤进行排查和优化,文中通过代码介绍... 目录前言一、初步定位问题1.1 确认进程状态1.2 确定Java进程ID1.3 快速生成线程堆栈二、分析

Java中的登录技术保姆级详细教程

《Java中的登录技术保姆级详细教程》:本文主要介绍Java中登录技术保姆级详细教程的相关资料,在Java中我们可以使用各种技术和框架来实现这些功能,文中通过代码介绍的非常详细,需要的朋友可以参考... 目录1.登录思路2.登录标记1.会话技术2.会话跟踪1.Cookie技术2.Session技术3.令牌技

java中BigDecimal里面的subtract函数介绍及实现方法

《java中BigDecimal里面的subtract函数介绍及实现方法》在Java中实现减法操作需要根据数据类型选择不同方法,主要分为数值型减法和字符串减法两种场景,本文给大家介绍java中BigD... 目录Java中BigDecimal里面的subtract函数的意思?一、数值型减法(高精度计算)1.

Macos创建python虚拟环境的详细步骤教学

《Macos创建python虚拟环境的详细步骤教学》在macOS上创建Python虚拟环境主要通过Python内置的venv模块实现,也可使用第三方工具如virtualenv,下面小编来和大家简单聊聊... 目录一、使用 python 内置 venv 模块(推荐)二、使用 virtualenv(兼容旧版 P

C/C++ chrono简单使用场景示例详解

《C/C++chrono简单使用场景示例详解》:本文主要介绍C/C++chrono简单使用场景示例详解,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友... 目录chrono使用场景举例1 输出格式化字符串chrono使用场景China编程举例1 输出格式化字符串示

C++/类与对象/默认成员函数@构造函数的用法

《C++/类与对象/默认成员函数@构造函数的用法》:本文主要介绍C++/类与对象/默认成员函数@构造函数的用法,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录名词概念默认成员函数构造函数概念函数特征显示构造函数隐式构造函数总结名词概念默认构造函数:不用传参就可以

Pytorch介绍与安装过程

《Pytorch介绍与安装过程》PyTorch因其直观的设计、卓越的灵活性以及强大的动态计算图功能,迅速在学术界和工业界获得了广泛认可,成为当前深度学习研究和开发的主流工具之一,本文给大家介绍Pyto... 目录1、Pytorch介绍1.1、核心理念1.2、核心组件与功能1.3、适用场景与优势总结1.4、优

C++类和对象之默认成员函数的使用解读

《C++类和对象之默认成员函数的使用解读》:本文主要介绍C++类和对象之默认成员函数的使用方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、默认成员函数有哪些二、各默认成员函数详解默认构造函数析构函数拷贝构造函数拷贝赋值运算符三、默认成员函数的注意事项总结一