Profiler Object:Iterators
All of the iterator functions have the same usage.
- You call the Start function to initiate it's respective iterator, with the column name and the order parameters.
- Then call the Get function(s) to get value(s) for a record.
- Then the GetNext function to step to the next record. When the GetNext call returns false, there are no more values.
You do not have to completely run through each value and you can stop at any time. No function call is necessary to terminate an iterator. Also, you can reset the iterator by calling the Start function. You are allowed to have multiple iterators (of different types) active at the same time. However, you should be aware that each iterator may return a different number of values, so stepping through multiple iterators in a single loop construction is generally a bad idea. It is impossible for you to use multiple iterators (of the same type) at the same time.