Partition Function

Partition Function

---

Class

Microsoft.VisualBasic.Interaction

Syntax

 Partition(   number, start, stop, interval   ) 

number (required; Long)

Number to evaluate against the intervals.

start (required; Long)

Start of the range. Must be non-negative.

stop (required; Long)

End of the range. Must be greater than start .

interval (required; Long)

Size of each interval into which the range is partitioned.

Return Value

A String containing the range within which number falls

Description

Returns a string that describes which interval contains the number

Rules at a Glance

• 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 .

Example

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: 

Programming Tips and Gotchas

• The Partition function is useful in creating histograms, which give the number of integers from a collection that fall into various ranges.

VB.NET/VB 6 Differences

• The Partition function is new to VB.NET.