VB.NET Language in a Nutshell, Second Edition

Name

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