Interaction.Partition(Int64, Int64, Int64, Int64) メソッド

リファレンス

定義

名前空間:: Microsoft.VisualBasic

アセンブリ:: Microsoft.VisualBasic.Core.dll

アセンブリ:: Microsoft.VisualBasic.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

ある数値が含まれる計算済み範囲を表す文字列を返します。

public:
 static System::String ^ Partition(long Number, long Start, long Stop, long Interval);

public static string Partition (long Number, long Start, long Stop, long Interval);

static member Partition : int64 * int64 * int64 * int64 -> string

Public Function Partition (Number As Long, Start As Long, Stop As Long, Interval As Long) As String

パラメーター

Number: Int64

必須です。 Long. 計算済み範囲のいずれかに存在する整数値です。

Start: Int64

必須です。 Long. 計算済み範囲のセットの最小値を示す整数です。 Start を 0 未満に設定することはできません。

Stop: Int64

必須です。 Long. 計算済み範囲のセットの最大値を示す整数です。 Stop には Start 以下の値を指定できません。

Interval: Int64

必須です。 Long. Start と Stop の間で計算される、各範囲のサイズを示す整数値です。 Interval を 1 未満に設定することはできません。

戻り値

String

ある数値が含まれる計算済み範囲を表す文字列。

例外

ArgumentException

Start < 0、Stop <= Start、または Interval < 1。

例

次の例では、1950 年から 2049 年までの数十年間の範囲のシリーズを設定します。適切な範囲内の year 値を検索し、範囲を示す値を String 返します。たとえばPartition、値が 1984 の場合year、"1980:1989" が返されます。

Dim year As Long = 1984
' Assume the value of year is provided by data or by user input.
Dim decade As String
decade = Partition(year, 1950, 2049, 10)
MsgBox("Year " & CStr(year) & " is in decade " & decade & ".")

注釈

この関数は Partition 、指定された Interval値の数を含む数値範囲のセットを計算します。最初の範囲は、で始まり Start、最後の範囲 Stopは . 次に、この関数は Partition 、どの範囲が Number 含まれているかを識別し、その範囲を説明する文字列を返します。範囲は文字列内で "lowervalue:uppervalue" として表され、範囲の下端 (下値) はコロン (:)) で上限 (上値) から区切られます。

必要に応じて、Partitionこの関数は、値 (Stop+ 1) の文字列表現と同じ文字数になるように、下値と上値の前に先頭のスペースを挿入します。これにより、複数の値を持つ関数の出力を Partition 使用すると、後続の Number並べ替え操作中に結果のテキストが適切に処理されます。

次の表は、3 つのセットの、Stop、およびIntervalを使用して計算された範囲のStartサンプル文字列を示しています。 "最初の範囲" 列と "最後の範囲" 列には、可能な限り最も低い範囲と最高のStart``Stop範囲が表示されます。 [最初の範囲の前] 列と [最後の範囲の後] 列には、それぞれより小さいStart値とそれより大きいStop値にNumber対して返される文字列が表示されます。

`Start`	`Stop`	`Interval`	最初の範囲の前	最初の範囲	最後の範囲	最後の範囲の後
0	99	5	" : -1"	" 0: 4"	" 95: 99"	"100: "
20	199	10	" : 19"	" 20: 29"	"190:199"	"200: "
100	1010	20	" : 99"	" 100: 119"	"1000:1010"	"1011: "

前の表の 3 行目は、均等に除算Intervalできない数値のセットを定義した場合Start``Stopの結果を示しています。最後の範囲 Stopは 20 であっても 11 個の長さ Interval になります。

1 の場合Interval、引数とStop引数に関係なくStart、範囲は "Number:Number" になります。たとえば、267、1000、 Stop Interval 1 の場合Numberは、Partition"267: 267" を返します。

Partition は、データベースクエリを作成するときに役立ちます。さまざまな値の範囲内で発生する注文の数を示す SELECT クエリを作成できます。たとえば、請求書の値が 1 ~ 1000、1001 から 2000 などです。

適用対象