Description: Allows a linear search through a dictionary in place. i.e. without copying the contents to an array.
Returns: Varies
Usage: Script
Format: GetNextKey(Dictionary[, Key, Order, KeyFound ] )
Parameters: Dictionary { Dictionary } { required } { no default }
Any dictionary you wish to search.
Key { <value> } { optional } { default: first key }
The key to start from. If this is invalid, or if the key is not found in the dictionary, then the first key in the given order will be returned.
Order { Boolean } { optional } { no default }
If FALSE then the search will be ordered alphabetically by key. If TRUE, then the search will be by order of key addition.
Key Found { <output variable> } { optional } { default: invalid }
Upon completion of the function, this value will receive the key of the record found, which matches with the value of that record returned by the function. If there are no further keys in the given order, this value will be set to INVALID.
Comments The return value is the value associated with the key found, or INVALID if no key was found.
Only the first parameter is required.