Profiler Object:Iterators: Difference between revisions
Jump to navigation
Jump to search
Created page with " ← Profiler Object Reference {| class="mw-collapsible" cellspacing="2" style="background-color:#f9f9f9; border:1px solid #aaaaaa; font-size..." |
No edit summary |
||
| (3 intermediate revisions by the same user not shown) | |||
| Line 2: | Line 2: | ||
[[Profiler Object:Reference|← Profiler Object Reference]] | [[Profiler Object:Reference|← Profiler Object Reference]] | ||
{ | {{ProfilerObjectNav | ||
|IteratorsCollapse= | |||
}} | |||
{ | |||
| | |||
<div class="toclimit-2">{{CustomTOC}}</div> | <div class="toclimit-2">{{CustomTOC}}</div> | ||
The Profiler allows the user to loop through every value, value length, pattern, date/time, sound of a value (Soundex), every word, and length of each word in a column to report how many times that element (value, length, pattern..etc) appears in the specified column. | |||
All of the iterator functions have the same usage. | All of the iterator functions have the same usage. | ||
| Line 93: | Line 20: | ||
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. | 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. | ||
==Order Enumerations== | |||
This enumeration is used as an input parameter to several of the enumerator functions: '''[[Profiler Object:Column-Based Value Frequency Table Iteration#StartDataFrequency|StartDataFrequency]]''', '''[[Profiler Object:Column-Based Value Length Frequency Table Iteration#StartLengthFrequency|StartLengthFrequency]]''', '''[[Profiler Object:Column-Based Value Pattern Table Iteration#StartPatternFrequency|StartPatternFrequency]]''', '''[[Profiler Object:Column-Based Value Date/Time Table Iteration#StartDateFrequency|StartDateFrequency]]''', '''[[Profiler Object:Column-Based Value SoundEx Table Iteration#StartSoundExFrequency|StartSoundExFrequency]]''', '''[[Profiler Object:Column-Based Word Table Iteration#StartWordFrequency|StartWordFrequency]]''' and '''[[Profiler Object:Column-Based Word Length Table Iteration#StartWordLengthFrequency|StartWordLengthFrequency]]'''. | |||
{|class="alternate01" cellspacing="0" | |||
!Value | |||
!Name | |||
!Description | |||
|- | |||
|0 | |||
|OrderNone | |||
|No particular order. | |||
|- | |||
|1 | |||
|OrderValueAscending | |||
|Values are ordered in Ascending order. | |||
|- | |||
|2 | |||
|OrderValueDescending | |||
|Values are ordered in Descending order. | |||
|- | |||
|3 | |||
|OrderCountAscending | |||
|Order by count in Ascending. | |||
|- | |||
|4 | |||
|OrderCountDescending | |||
|Order by count in Descending. | |||
|} | |||
[[Category:Profiler Object]] | [[Category:Profiler Object]] | ||
Latest revision as of 23:58, 2 March 2015
The Profiler allows the user to loop through every value, value length, pattern, date/time, sound of a value (Soundex), every word, and length of each word in a column to report how many times that element (value, length, pattern..etc) appears in the specified column.
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.
Order Enumerations
This enumeration is used as an input parameter to several of the enumerator functions: StartDataFrequency, StartLengthFrequency, StartPatternFrequency, StartDateFrequency, StartSoundExFrequency, StartWordFrequency and StartWordLengthFrequency.
| Value | Name | Description |
|---|---|---|
| 0 | OrderNone | No particular order. |
| 1 | OrderValueAscending | Values are ordered in Ascending order. |
| 2 | OrderValueDescending | Values are ordered in Descending order. |
| 3 | OrderCountAscending | Order by count in Ascending. |
| 4 | OrderCountDescending | Order by count in Descending. |