Ets_Output_Value_Cache_Row_Lookup()
Abstract
Looks up the row for an object in the table associated with a given output value.
Syntax
Ets_Output_Value_Cache_Row_Lookup (cache_ptr, obj_name, row_idx_ptr)
| Argument | Type | Description |
|---|---|---|
cache_ptr |
EtsT_Output_Value_Cache * |
Output cache containing the registered value of interest. |
obj_name |
const char * |
Hierarchical name. Owned by caller. |
row_idx_ptr |
long * |
If input as a value >= 0, the output row will be the next matching row after this row. On return, this is set to the requested output row number (if successful) or -1 (if unsuccessful). |
Return Type
EtsT_Compcode
EtsC_Compcode_Success if found and output in row_idx_ptr; EtsC_Compcode_Failure if not in the cache.
Header
ets_api_output.h
Details
The value is known only if it has been previously cached using Ets_Output_Value_Cache_Row_Entry_Add(). The intent is to avoid expensive iterations over a table seeking a specific row.