sqlite_connect结构体 参考

SQLite数据库连接类 更多...

#include <sqlite_connect.hpp>

类 sqlite_connect 继承关系图:

Public 成员函数
	sqlite_connect () noexcept
	默认构造函数
	~sqlite_connect () noexcept override
	析构函数
bool	connect (const db_config &config) override
	建立数据库连接
NEFORCE_NODISCARD bool	reconnect (const db_config &config) override
	重新连接数据库
void	close () noexcept override
	关闭数据库连接
NEFORCE_NODISCARD bool	set_character_set (const string &encoding) const override
	设置字符集
NEFORCE_NODISCARD string_view	get_character_set () const override
	获取当前字符集
NEFORCE_NODISCARD string_view	get_error () const override
	获取最后错误信息
NEFORCE_NODISCARD uint32_t	get_errno () const override
	获取最后错误码
NEFORCE_NODISCARD bool	update (const string &sql) const override
	执行非查询SQL语句
NEFORCE_NODISCARD unique_ptr< idb_tb_result >	query (const string &sql) const override
	执行查询SQL语句
NEFORCE_NODISCARD unique_ptr< idb_prepared_statement >	prepare_statement (const string &sql) const override
	创建预处理语句
NEFORCE_NODISCARD bool	connected () const override
	检查连接是否已建立
NEFORCE_NODISCARD bool	is_valid () const override
	检查连接是否有效
Public 成员函数 继承自 idb_connect
void	refresh_alive () noexcept
	刷新连接存活时间
NEFORCE_NODISCARD clock_type	get_alive () const noexcept
	获取连接空闲时间

额外继承的成员函数
Public 类型 继承自 idb_connect
using	clock_type = milliseconds
	存活时间计时器类型

详细描述

SQLite数据库连接类

实现idb_tb_connect接口，提供SQLite数据库的连接和操作功能。

主要功能：

• SQLite数据库连接建立和关闭
• 字符集设置和查询
• SQL语句执行
• 查询结果获取
• 预处理语句支持
• 连接健康检查

注解

SQLite连接是文件级别的，database字段指定数据库文件路径。 支持内存数据库（":memory:"）。

在文件 sqlite_connect.hpp 第 45 行定义.

构造及析构函数说明

sqlite_connect()

sqlite_connect::sqlite_connect ( )

inlinenoexcept

默认构造函数

创建内存数据库连接（临时数据库）。

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

~sqlite_connect()

sqlite_connect::~sqlite_connect ( )

inlineoverridenoexcept

析构函数

自动关闭数据库连接。

在文件 sqlite_connect.hpp 第 63 行定义.

引用了 idb_connect::close().

成员函数说明

connect()

bool sqlite_connect::connect ( const db_config & config )

overridevirtual

建立数据库连接

参数

config

连接配置

返回

连接成功返回true

打开config.database指定的数据库文件。 如果database为空，创建内存数据库。

实现了 idb_connect.

connected()

NEFORCE_NODISCARD bool sqlite_connect::connected ( ) const

inlineoverridevirtual

检查连接是否已建立

返回

已连接返回true

实现了 idb_connect.

在文件 sqlite_connect.hpp 第 139 行定义.

get_character_set()

NEFORCE_NODISCARD string_view sqlite_connect::get_character_set ( ) const

overridevirtual

获取当前字符集

返回

字符集名称

实现了 idb_connect.

引用了 get_character_set().

被这些函数引用 get_character_set().

get_errno()

NEFORCE_NODISCARD uint32_t sqlite_connect::get_errno ( ) const

inlineoverridevirtual

获取最后错误码

返回

SQLite错误码

实现了 idb_connect.

在文件 sqlite_connect.hpp 第 112 行定义.

引用了 get_errno().

被这些函数引用 get_errno().

get_error()

NEFORCE_NODISCARD string_view sqlite_connect::get_error ( ) const

overridevirtual

获取最后错误信息

返回

错误描述字符串

实现了 idb_connect.

引用了 get_error().

被这些函数引用 get_error().

is_valid()

NEFORCE_NODISCARD bool sqlite_connect::is_valid ( ) const

overridevirtual

检查连接是否有效

返回

有效返回true

实现了 idb_connect.

prepare_statement()

NEFORCE_NODISCARD unique_ptr< idb_prepared_statement > sqlite_connect::prepare_statement ( const string & sql ) const

overridevirtual

创建预处理语句

参数

sql	带占位符的SQL语句

返回

预处理语句对象

实现了 idb_tb_connect.

query()

NEFORCE_NODISCARD unique_ptr< idb_tb_result > sqlite_connect::query ( const string & sql ) const

overridevirtual

执行查询SQL语句

参数

sql

SELECT语句

返回

查询结果集，失败返回空指针

实现了 idb_tb_connect.

reconnect()

NEFORCE_NODISCARD bool sqlite_connect::reconnect ( const db_config & config )

overridevirtual

重新连接数据库

参数

config

连接配置

返回

重连成功返回true

关闭当前连接，使用新配置重新连接。

实现了 idb_connect.

set_character_set()

NEFORCE_NODISCARD bool sqlite_connect::set_character_set ( const string & encoding ) const

overridevirtual

设置字符集

参数

encoding

字符集名称

返回

设置成功返回true

实现了 idb_connect.

引用了 set_character_set().

被这些函数引用 set_character_set().

update()

NEFORCE_NODISCARD bool sqlite_connect::update ( const string & sql ) const

overridevirtual

执行非查询SQL语句

参数

sql

SQL语句

返回

执行成功返回true

实现了 idb_connect.

---

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

• sqlite_connect.hpp