DB_Close
描述
关闭通过DB_Open建立的 SQLite 数据库连接。
| 参数 | 说明 |
|---|---|
| DB:db | 要关闭的数据库连接句柄(由DB_Open返回) |
返回值
true - 函数执行成功
false - 函数执行失败(可能由于数据库连接句柄无效)
示例
static DB:gDBConnectionHandle;
// ...
public OnGameModeInit()
{
// ...
// 创建数据库连接
gDBConnectionHandle = DB_Open("example.db");
// 检测数据库连接状态
if (gDBConnectionHandle)
{
// 成功建立连接
print("成功连接数据库 \"example.db\"");
}
else
{
// 连接失败
print("无法连接数据库 \"example.db\"");
}
// ...
return 1;
}
public OnGameModeExit()
{
// 关闭已存在的数据库连接
if (DB_Close(gDBConnectionHandle))
{
// 清理句柄
gDBConnectionHandle = DB:0;
}
// ...
return 1;
}
注意事项
注意
使用非零的无效句柄将导致服务器崩溃!请始终使用DB_Open获取有效数据库连接句柄
相关函数
- DB_Open: 建立 SQLite 数据库连接
- DB_Close: 关闭 SQLite 数据库连接
- DB_ExecuteQuery: 执行 SQL 查询语句
- DB_FreeResultSet: 释放查询结果集内存
- DB_GetRowCount: 获取结果集行数
- DB_SelectNextRow: 选择下一行数据
- DB_GetFieldCount: 获取结果集字段数量
- DB_GetFieldName: 通过索引获取字段名称
- DB_GetFieldString: 通过字段索引获取字符串数据
- DB_GetFieldStringByName: 通过字段名称获取字符串数据
- DB_GetFieldInt: 通过字段索引获取整型数据
- DB_GetFieldIntByName: 通过字段名称获取整型数据
- DB_GetFieldFloat: 通过字段索引获取浮点数据
- DB_GetFieldFloatByName: 通过字段名称获取浮点数据
- DB_GetMemHandle: 获取通过 DB_Open 打开的 SQLite 数据库的内存句柄
- DB_GetLegacyDBResult: 获取通过 DB_ExecuteQuery 执行的 SQLite 查询结果的内存句柄
- DB_GetDatabaseConnectionCount: 调试用-获取数据库连接数
- DB_GetDatabaseResultSetCount: 调试用-获取结果集数量