status 获取函数调用结果
获得结果集之后, 第一步都应该先调用本成员函数判断查询数据是否成功。
函数原型:
int status()
参数:
参数名 | 类型 | 说明 |
---|---|---|
返回值 | int | 0: 成功, 非0: 错误码 |
注意:
1. 如果status 断定为失败时, 不应该再遍历结果集, 这时直接释放结果集即可。
is_end 判断是否到达结果集末尾
获得结果集之后, 默认指向结果集的第一条记录。如果 is_end返回true, 则表示没有指向有效的记录了, 遍历应该就此结束。
函数原型:
bool is_end()
参数:
参数名 | 类型 | 说明 |
---|---|---|
返回值 | bool | true: 已到结果集末尾,当前记录无效, false: 未到结果集末尾,当前记录有效 |
next 移到下一条记录
移到下一条记录, 先用 is_end 判断记录是否有效,再取值。
函数原型:
void next()
get_integer 获取整型值
如果当前记录有效, 则可取值
函数原型:
int get_integer(const char *key)
参数:
参数名 | 类型 | 说明 |
---|---|---|
key | const char * | 字段名 |
返回值 | int | 所取的字段值 |
get_long_integer 获取长整型值
如果当前记录有效, 则可取值
函数原型:
long long get_long_integer(const char *key)
参数:
参数名 | 类型 | 说明 |
---|---|---|
key | const char * | 字段名 |
返回值 | long long | 所取的字段值 |
get_real 获取浮点型值
如果当前记录有效, 则可取值
函数原型:
double get_real(const char *key)
参数:
参数名 | 类型 | 说明 |
---|---|---|
key | const char * | 字段名 |
返回值 | double | 所取的字段值 |
get_string 获取字符串值
如果当前记录有效, 则可取值
函数原型:
const char* get_string(const char *key);
参数:
参数名 | 类型 | 说明 |
---|---|---|
key | const char * | 字段名 |
返回值 | const char* | 所取的字段值 |
release 释放数据集合
获取DataSet指针之后,最后都应该释放数据集合(不管status是什么状态), 不然会造成内存泄露。调用release之后,不能再调用结果集任何成员函数。
函数原型:
void release()
debug_string 返回整个结果集信息
使用调试,快速知道结果集的表结构
函数原型:
const char* debug_string();
参数:
参数名 | 类型 | 说明 |
---|---|---|
返回值 | const char* | 整个结果集信息 |