Ets_Output_Value_Cache_Row_Lookup()
摘要
在某个输出值关联的表中查找某对象对应的行。
语法
Ets_Output_Value_Cache_Row_Lookup (cache_ptr, obj_name, row_idx_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
cache_ptr |
EtsT_Output_Value_Cache * |
包含目标注册取值的输出缓存。 |
obj_name |
const char * |
层次名称。归调用方所有。 |
row_idx_ptr |
long * |
若以 >= 0 的值作为输入,输出的行将是该行之后的下一个匹配行。 返回时,该值被设置为所请求的输出行号(成功时)或 -1(失败时)。 |
返回类型
EtsT_Compcode
若找到并通过 row_idx_ptr 输出则返回 EtsC_Compcode_Success;若不在缓存中则返回 EtsC_Compcode_Failure。
头文件
ets_api_output.h
详情
只有先前通过 Ets_Output_Value_Cache_Row_Entry_Add() 缓存过的取值才为系统所知。其用意是避免为寻找特定行而对表进行代价高昂的遍历。