...
| Code Block | ||||
|---|---|---|---|---|
| ||||
FUNCTION xpfGetHashedValue(hashTableIndex, index : |
...
INTEGER;
hashedValue : GENERIC)
instanceId : GENERIC;
|
The xpfGetHashedValue function looks up in the specified hash table for instances that match the given ?lookup value?. The hashTableIndex identifies the actual hash table. The hashTableIndex is returned by a previous xpxMakeHashTable operation when the actual hash table was created. The argument hashedValue is the actual value of the attribute which is specified as key. The argument index is the index in the hash table for all elements in the hash table that exactly matches the specified hashedValue. index start with the value 1. instanceId is the returned value that uniquely identifies the instance in the hash table that matches the ?lookup value?: hashTableIndex, index and hashedValue.
This function returns the constant xpxNullId when no matching instance is found in the actual hash table.
Using the mechanism of hash table will considerable improve performance when searching a collection of instances for matching attribute values.
Related operations: xpxGetHashedValue, xpfMakeHashTable, xpxMakeHashTable, xpxDeleteHashTable.
Arguments
...
| Type | Name | Comment |
| INTEGER | hashTableIndex | |
| INTEGER | index | |
| GENERIC | hashedValue |
Return Value
...
| Type | Name | Comment |
| GENERIC | instanceId | comments |
Options
...
Example
...
| Code Block | ||
|---|---|---|
| ||
<Missing Example> |
See also
| Filter by label (Content by label) | ||||||
|---|---|---|---|---|---|---|
|