SQLite查询结果集类更多...

#include <sqlite_result.hpp>

类 neforce::sqlite_result 继承关系图:

Public 成员函数
	sqlite_result ()
	默认构造函数
	sqlite_result (::sqlite3_stmt *statement)
	构造函数
	sqlite_result (::sqlite3_stmt *statement, sqlite_cleanup_action cleanup)
	构造函数（带清理方式）
	~sqlite_result () override
	析构函数
size_type	row_count () const noexcept override
	获取结果集行数
size_type	column_count () const noexcept override
	获取结果集列数
bool	empty () const noexcept override
	检查结果集是否为空
const vector< string_view > &	column_names () const noexcept override
	获取列名列表
column_meta	column_metadata (size_type n) const override
	获取列元数据
const vector< int > &	column_types () const noexcept
	获取列类型列表
bool	next () noexcept override
	移动到下一行
string_view	get (size_type n) const noexcept override
	获取字符串值
bool	get_bool (size_type n) const override
	获取布尔值
int16_t	get_int16 (size_type n) const override
	获取16位整数值
int32_t	get_int32 (size_type n) const override
	获取32位整数值
int64_t	get_int64 (size_type n) const override
	获取64位整数值
float32_t	get_float32 (size_type n) const override
	获取32位浮点值
float64_t	get_float64 (size_type n) const override
	获取64位浮点值
decimal_t	get_decimal (size_type n) const override
	获取十进制值
vector< char >	get_blob (size_type n) const override
	获取BLOB二进制数据
uint64_t	get_bit (size_type n) const noexcept override
	获取BIT位字段值
date	get_date (size_type n) const override
	获取日期值
time	get_time (size_type n) const override
	获取时间值
datetime	get_datetime (size_type n) const override
	获取日期时间值
timestamp	get_timestamp (size_type n) const override
	获取时间戳值

额外继承的成员函数
Public 类型继承自 neforce::idb_result
using	size_type = size_t
	大小类型
using	difference_type = ptrdiff_t
	差值类型

详细描述

SQLite查询结果集类

实现idb_tb_result接口，提供SQLite查询结果的访问功能。支持结果集遍历、列名获取和类型安全的数据读取。

主要功能：

结果集元数据获取
逐行遍历结果集
支持多种数据类型转换
NULL值处理
自动语句资源管理（finalize或reset）

注解: 普通查询使用finalize模式（默认），预处理语句查询使用reset模式以允许语句复用。

在文件 sqlite_result.hpp 第 56 行定义.

构造及析构函数说明

◆ sqlite_result() [1/3]

neforce::sqlite_result::sqlite_result ( )

默认构造函数

创建空结果集。

◆ sqlite_result() [2/3]

neforce::sqlite_result::sqlite_result ( ::sqlite3_stmt * statement )

explicit

构造函数

参数

statement SQLite预处理语句句柄

获取结果集的列数、列名和列类型信息。默认使用finalize清理方式。

◆ sqlite_result() [3/3]

neforce::sqlite_result::sqlite_result	(	::sqlite3_stmt *	statement,
		sqlite_cleanup_action	cleanup )

构造函数（带清理方式）

参数

statement	SQLite预处理语句句柄
cleanup	清理方式（finalize或reset）

预处理语句查询应使用reset方式，以允许语句复用。

◆ ~sqlite_result()

neforce::sqlite_result::~sqlite_result ( )

override

析构函数

根据cleanup_标志调用sqlite3_finalize或sqlite3_reset。

成员函数说明

◆ column_count()

size_type neforce::sqlite_result::column_count ( ) const

inlinenodiscardoverridevirtualnoexcept

获取结果集列数

返回: 总列数

实现了 neforce::idb_tb_result.

在文件 sqlite_result.hpp 第 113 行定义.

◆ column_metadata()

column_meta neforce::sqlite_result::column_metadata ( size_type n ) const

nodiscardoverridevirtual

获取列元数据

参数

n 列索引（从0开始）

返回: 列元数据

实现了 neforce::idb_tb_result.

◆ column_names()

const vector< string_view > & neforce::sqlite_result::column_names ( ) const

inlinenodiscardoverridevirtualnoexcept

获取列名列表

返回: 列名视图列表

实现了 neforce::idb_tb_result.

在文件 sqlite_result.hpp 第 125 行定义.

◆ column_types()

const vector< int > & neforce::sqlite_result::column_types ( ) const

inlinenodiscardnoexcept

获取列类型列表

返回: SQLite类型代码列表

在文件 sqlite_result.hpp 第 133 行定义.

◆ empty()

bool neforce::sqlite_result::empty ( ) const

inlinenodiscardoverridevirtualnoexcept

检查结果集是否为空

返回: 空结果集返回true

实现了 neforce::idb_result.

在文件 sqlite_result.hpp 第 119 行定义.

◆ get()

string_view neforce::sqlite_result::get ( size_type n ) const

nodiscardoverridevirtualnoexcept

获取字符串值

参数

n 列索引（从0开始）

返回: 字符串视图，NULL返回空字符串

实现了 neforce::idb_tb_result.

引用了 get().

被这些函数引用 get().

◆ get_bit()

uint64_t neforce::sqlite_result::get_bit ( size_type n ) const

nodiscardoverridevirtualnoexcept

获取BIT位字段值

参数

n 列索引

返回: 位字段的整数值

实现了 neforce::idb_tb_result.

引用了 get_bit().

被这些函数引用 get_bit().

◆ get_blob()

vector< char > neforce::sqlite_result::get_blob ( size_type n ) const

nodiscardoverridevirtual

获取BLOB二进制数据

参数

n 列索引

返回: 字节向量

实现了 neforce::idb_tb_result.

引用了 get_blob().

被这些函数引用 get_blob().

◆ get_bool()

bool neforce::sqlite_result::get_bool ( size_type n ) const

nodiscardoverridevirtual

获取布尔值

参数

n 列索引

返回: 布尔值（非0为true）

实现了 neforce::idb_tb_result.

引用了 get_bool().

被这些函数引用 get_bool().

◆ get_date()

date neforce::sqlite_result::get_date ( size_type n ) const

inlinenodiscardoverridevirtual

获取日期值

参数

n 列索引

返回: 日期对象

实现了 neforce::idb_tb_result.

在文件 sqlite_result.hpp 第 216 行定义.

引用了 neforce::datetime::date(), get_date() , 以及 neforce::idb_tb_result::get_datetime().

被这些函数引用 get_date().

◆ get_datetime()

datetime neforce::sqlite_result::get_datetime ( size_type n ) const

nodiscardoverridevirtual

获取日期时间值

参数

n 列索引

返回: 日期时间对象

解析SQLite的文本格式日期时间

实现了 neforce::idb_tb_result.

◆ get_decimal()

decimal_t neforce::sqlite_result::get_decimal ( size_type n ) const

nodiscardoverridevirtual

获取十进制值

参数

n 列索引

返回: 十进制数对象

实现了 neforce::idb_tb_result.

引用了 get_decimal().

被这些函数引用 get_decimal().

◆ get_float32()

float32_t neforce::sqlite_result::get_float32 ( size_type n ) const

nodiscardoverridevirtual

获取32位浮点值

参数

n 列索引

返回: 32位浮点数

实现了 neforce::idb_tb_result.

引用了 get_float32().

被这些函数引用 get_float32().

◆ get_float64()

float64_t neforce::sqlite_result::get_float64 ( size_type n ) const

nodiscardoverridevirtual

获取64位浮点值

参数

n 列索引

返回: 64位浮点数

实现了 neforce::idb_tb_result.

引用了 get_float64().

被这些函数引用 get_float64().

◆ get_int16()

int16_t neforce::sqlite_result::get_int16 ( size_type n ) const

nodiscardoverridevirtual

获取16位整数值

参数

n 列索引

返回: 16位整数

实现了 neforce::idb_tb_result.

引用了 get_int16().

被这些函数引用 get_int16().

◆ get_int32()

int32_t neforce::sqlite_result::get_int32 ( size_type n ) const

nodiscardoverridevirtual

获取32位整数值

参数

n 列索引

返回: 32位整数

实现了 neforce::idb_tb_result.

引用了 get_int32().

被这些函数引用 get_int32().

◆ get_int64()

int64_t neforce::sqlite_result::get_int64 ( size_type n ) const

nodiscardoverridevirtual

获取64位整数值

参数

n 列索引

返回: 64位整数

实现了 neforce::idb_tb_result.

引用了 get_int64().

被这些函数引用 get_int64().

◆ get_time()

time neforce::sqlite_result::get_time ( size_type n ) const

inlinenodiscardoverridevirtual

获取时间值

参数

n 列索引

返回: 时间对象

实现了 neforce::idb_tb_result.

在文件 sqlite_result.hpp 第 223 行定义.

引用了 neforce::idb_tb_result::get_datetime() , 以及 neforce::datetime::time().

◆ get_timestamp()

timestamp neforce::sqlite_result::get_timestamp ( size_type n ) const

nodiscardoverridevirtual

获取时间戳值

参数

n 列索引

返回: 时间戳对象

将Unix时间戳整数转换为timestamp对象。

实现了 neforce::idb_tb_result.

◆ next()

bool neforce::sqlite_result::next ( )

nodiscardoverridevirtualnoexcept

移动到下一行

返回: 成功移动返回true，到达末尾返回false

实现了 neforce::idb_result.

◆ row_count()

size_type neforce::sqlite_result::row_count ( ) const

inlinenodiscardoverridevirtualnoexcept

获取结果集行数

返回: 始终返回0

弃用: SQLite无法高效获取行数，建议使用COUNT(*)

实现了 neforce::idb_tb_result.

在文件 sqlite_result.hpp 第 105 行定义.

引用了 row_count().

被这些函数引用 row_count().

该结构体的文档由以下文件生成:

sqlite_result.hpp

Public 成员函数

额外继承的成员函数

详细描述

构造及析构函数说明

◆ sqlite_result() [1/3]

◆ sqlite_result() [2/3]

◆ sqlite_result() [3/3]

◆ ~sqlite_result()

成员函数说明

◆ column_count()

◆ column_metadata()

◆ column_names()

◆ column_types()

◆ empty()

◆ get()

◆ get_bit()

◆ get_blob()

◆ get_bool()

◆ get_date()

◆ get_datetime()

◆ get_decimal()

◆ get_float32()

◆ get_float64()

◆ get_int16()

◆ get_int32()

◆ get_int64()

◆ get_time()

◆ get_timestamp()

◆ next()

◆ row_count()