rdbapi 5.1.1.9
实时数据库C接口 for windows/Linux
 
载入中...
搜索中...
未找到
标签管理相关相关接口

函数

int rdb_taginport (int h, unsigned int dwflag, rec_tag *ptag, int *presult)
 导入(添加,更改)标签
 
int rdb_tagget (int h, rec_tag *ptag)
 读取标签属性记录
 
int rdb_tagdel (int h, const char *sname)
 删除标签
 
int rdb_tagquery (int h, const char *snamefilter, const char *sdesfilter, int ndatatype, int ntagclass, rdbcb_OnReadTags pfun, void *pParam)
 查询标签
 
int rdb_tagext_inport (int h, tag_ext *pext, uint32_t umask)
 导入标签扩展属性
 
int rdb_tagext_get (int h, tag_ext *ptags, int size)
 获取一批标签扩展属性
 
int rdb_tagext_del (int h, const char *tagname)
 删除一个标签的扩展属性
 

详细描述

标签查询,修改属性,增加删除等。

函数说明

◆ rdb_tagdel()

int rdb_tagdel ( int h,
const char * sname )

删除标签

参数
h[in] rdb_create创建的句柄.
sname[in] 要删除的标签名.
返回
返回 0 表示成功,其余值为失败错误码。
备注
删除标签的同时删除历史数据并释放实时库内部逻辑存储页面。

◆ rdb_tagext_del()

int rdb_tagext_del ( int h,
const char * tagname )

删除一个标签的扩展属性

参数
hrdb_create创建的句柄.
tagname[in] 标签名
返回
0: success; 其他为错误码

◆ rdb_tagext_get()

int rdb_tagext_get ( int h,
tag_ext * ptags,
int size )

获取一批标签扩展属性

参数
h[in] rdb_create创建的句柄.
ptags[in] in/out 标签扩展属性数组,输入时只填写标签名
size[in] ptags中标签个数
返回
0: success; 其他为错误码

◆ rdb_tagext_inport()

int rdb_tagext_inport ( int h,
tag_ext * pext,
uint32_t umask )

导入标签扩展属性

参数
h[in] rdb_create创建的句柄.
pext[in] 扩展属性结构体。
umask[in] 掩码
返回
0: success; 其他为错误码

◆ rdb_tagget()

int rdb_tagget ( int h,
rec_tag * ptag )

读取标签属性记录

参数
h[in] rdb_create创建的句柄.
ptag[in/out] 标签属性记录,调用前填写sname字段.
返回
返回 0 表示成功,其余值为失败错误码。成功调用后,ptag的其余字段被填写.

◆ rdb_taginport()

int rdb_taginport ( int h,
unsigned int dwflag,
rec_tag * ptag,
int * presult )

导入(添加,更改)标签

参数
h[in] rdb_create创建的句柄.
dwflag[in] 导入策略,指明当标签存在时修改哪些字段,参见TAG_MASK_DES
ptag[in] 标签记录指针
presult[out] 处理结果; 0未更改; 1修改了; 2添加了
返回
返回 0 表示成功,其余值为失败错误码

◆ rdb_tagquery()

int rdb_tagquery ( int h,
const char * snamefilter,
const char * sdesfilter,
int ndatatype,
int ntagclass,
rdbcb_OnReadTags pfun,
void * pParam )

查询标签

参数
h[in] rdb_create创建的句柄.
snamefilter[in] 标签名过滤串,空或*表示全部,支持*和?匹配
sdesfilter[in] 标签描述过滤串,空或*表示全部,支持*和?匹配
ndatatype[in] 标签名数据类型,-1表示全部
ntagclass[in] 标签分类,-1表示全部
pfun[in] 回调函数,参见rdbcb_OnReadTags,查询到标签记录后使用回调函数处理.
pParam[in] 回调函数的参数.
返回
返回 0 表示成功,其余值为失败错误码。
备注
当查询结束或者回调函数返回0时结束查询,也就是调用者可以中途终止查询.整个查询过程中,回调函数可能被调用多次.