VB .NET Language in a Nutshell

Name

Partition Function

Class

Microsoft.VisualBasic.Interaction

Syntax

Partition(number, start, stop, interval)

number

Use: Required

Data Type: Long

Number to evaluate against the intervals.

start

Use: Required

Data Type: Long

Start of the range. Must be non-negative.

stop

Use: Required

Data Type: Long

End of the range. Must be greater than start.

interval

Use: Required

Data Type: 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 Debug.WriteLine(CStr(i * 5) & " is in interval " & _ Partition(i * 5, 0, 100, ...