db_get_mem_handle
注意
这个$函数以小写字母开头。
注意
这个函数是在SA-MP 0.3.7 R1中添加的,在以前的版本中不起作用!
描述
获取通过db_open建立的 SQLite 数据库连接的内存句柄。
参数名 | 说明 |
---|---|
DB:db | 数据库连接句柄(由db_open返回) |
返回值
返回数据库连接句柄的内存句柄(十六进制表示)。
示例
static DB:gDBConnectionHandle;
// ...
public OnGameModeInit()
{
// ...
// 建立数据库连接
gDBConnectionHandle = db_open("example.db");
if (gDBConnectionHandle)
{
print("成功连接数据库 \"example.db\"");
printf("数据库连接内存句柄: 0x%x", db_get_mem_handle(gDBConnectionHandle));
}
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_query: 执行 SQL 查询语句
- db_free_result: 释放查询结果内存
- db_num_rows: 获取结果集行数
- db_next_row: 跳转至下一行数据
- db_num_fields: 获取结果集字段数量
- db_field_name: 通过索引获取字段名称
- db_get_field: 通过字段索引获取当前行数据
- db_get_field_assoc: 通过字段名称获取当前行数据
- db_get_field_int: 通过字段索引获取整型数据
- db_get_field_assoc_int: 通过字段名称获取整型数据
- db_get_field_float: 通过字段索引获取浮点数据
- db_get_field_assoc_float: 通过字段名称获取浮点数据
- db_get_result_mem_handle: 获取查询结果内存句柄
- db_debug_openfiles: 调试用-获取已打开的数据库连接数
- db_debug_openresults: 调试用-获取已打开的查询结果数