Partition Function |
Microsoft.VisualBasic.Interaction
Partition( number, start, stop, interval )
Number to evaluate against the intervals.
Start of the range. Must be non-negative.
End of the range. Must be greater than start .
Size of each interval into which the range is partitioned.
A String containing the range within which number falls
Returns a string that describes which interval contains the number
start must be greater than or equal to 0.
stop cannot be less than or equal to start .
Partition returns a range formatted with enough leading spaces so that there are the same number of characters to the left and right of the colon as there are characters in stop , plus one. This ensures that the interval text will be handled properly during any sort operations.
If number is outside of the range of start , the range reported is:
: ( start - 1)
If number is outside the range of end , the range reported is:
(last_end_range + 1):
If interval is 1, the range is number : number , regardless of the start and stop arguments. For example, if interval is 1, number is 100, and stop is 1000, Partition returns 100: 100 .
If any of its arguments are Null , Partition returns a Null .
The code:
Dim i As Integer For i = -1 To 110 \ 5 Console.WriteLine(CStr(i * 5) & " is in interval " & _ Partition(i * 5, 0, 100, 10)) Next
produces the following output:
-5 is in interval : -1 0 is in interval 0: 9 5 is in interval 0: 9 10 is in interval 10: 19 15 is in interval 10: 19 20 is in interval 20: 29 25 is in interval 20: 29 30 is in interval 30: 39 35 is in interval 30: 39 40 is in interval 40: 49 45 is in interval 40: 49 50 is in interval 50: 59 55 is in interval 50: 59 60 is in interval 60: 69 65 is in interval 60: 69 70 is in interval 70: 79 75 is in interval 70: 79 80 is in interval 80: 89 85 is in interval 80: 89 90 is in interval 90: 99 95 is in interval 90: 99 100 is in interval 100:100 105 is in interval 101: 110 is in interval 101:
The Partition function is useful in creating histograms, which give the number of integers from a collection that fall into various ranges.
The Partition function is new to VB.NET.