TIBCO FTL®
|
Map iterators iterate over the key/value pairs in a map. More...
Typedefs | |
typedef struct __tibMapIteratorId * | tibMapIterator |
Functions | |
TIB_API const char * | tibMapIterator_CurrentKey (tibEx e, tibMapIterator mapIterator) |
Get the key from the current key/value pair. More... | |
TIB_API tibMessage | tibMapIterator_CurrentValue (tibEx e, tibMapIterator mapIterator) |
Get the message value from the current key/value pair. More... | |
TIB_API void | tibMapIterator_Destroy (tibEx e, tibMapIterator mapIterator) |
Destroy a map iterator object, reclaiming its resources. More... | |
TIB_API tibbool_t | tibMapIterator_Next (tibEx e, tibMapIterator mapIterator) |
Iterate to the next key/value pair. More... | |
Map iterators iterate over the key/value pairs in a map.
An iterator can produce values added to a map after the iterator is created.
To create a map iterator object, see tibMap_CreateIterator.
This file defines map iterator calls.
typedef struct __tibMapIteratorId* tibMapIterator |
TIB_API const char* tibMapIterator_CurrentKey | ( | tibEx | e, |
tibMapIterator | mapIterator | ||
) |
Get the key from the current key/value pair.
The library owns the key string, and may destroy it after the program calls tibMapIterator_Next or tibMapIterator_Destroy.
e | The exception object captures information about failures. |
mapIterator | The call gets the key from the current pair of this iterator. |
TIB_API tibMessage tibMapIterator_CurrentValue | ( | tibEx | e, |
tibMapIterator | mapIterator | ||
) |
Get the message value from the current key/value pair.
The library owns the message object, and may destroy it after the program calls tibMapIterator_Next or tibMapIterator_Destroy.
e | The exception object captures information about failures. |
mapIterator | The call gets the value from the current pair of this iterator. |
TIB_API void tibMapIterator_Destroy | ( | tibEx | e, |
tibMapIterator | mapIterator | ||
) |
Destroy a map iterator object, reclaiming its resources.
e | The exception object captures information about failures. |
mapIterator | The call destroys this iterator object. |
TIB_API tibbool_t tibMapIterator_Next | ( | tibEx | e, |
tibMapIterator | mapIterator | ||
) |
Iterate to the next key/value pair.
If the iterator has an associated lock and the process does not hold that lock, the call throws an exception and does not advance to the next pair. (See also tibMap_CreateIteratorWithLock.)
To get the key and value from each pair, see tibMapIterator_CurrentKey and tibMapIterator_CurrentValue.
e | The exception object captures information about failures. |
mapIterator | The call advances the focus of this iterator to the next pair. |