next match patricia/string/vector
此函数将游标 cursor
移动到下一个与mask
中指定的键值匹配的记录。mask
必须是先前调用搜索函数(_longest_match
、_exact_match
或 _prefix_match
)时传递的初始匹配值)。
MCO_RET classname_indexname_next_match(
/*IN*/ mco_trans_h trans,
/*IN*/ mco_cursor_h cursor,
/*IN*/ char * mask,
/*IN*/ uint2 sizeofMask
);
参数
trans
mco_trans_h
由 mco_trans_start()
函数返回的事务句柄。
cursor
mco_cursor_h
由 *_index_cursor
返回的游标句柄。
mask
char
指定为字符串或向量的关键值。
sizeofMask
uint2
字符串或矢量参数mask
的长度。
返回
MCO_S_OK
找到了索引与mask
匹配的记录。
MCO_S_NOTFOUND
与mask
匹配的记录子集已完成。
MCO_E_DISK_NOT_OPENED
索引名称位于持久类中,且磁盘访问未通过 db_open_dev()
进行初始化。
MCO_E_VOLUNTARY_NOT_EXIST
索引名称是一个自愿创建的索引,尚未被创建。
MCO_E_NOMEM
内存不足。
MCO_ERR_CURSOR
游标操作中出现致命错误。