ReDim ステートメント (Visual Basic)

配列変数の記憶域を再割り当てします。

構文

ReDim [ Preserve ] name(boundlist) [ ,  name(boundlist) [, ... ] ]  

指定項目

用語 定義
Preserve 任意。 最後の次元のサイズだけを変更したときに、既存の配列のデータを保持するために使用する修飾子
name 必須です。 配列変数名。 「 Declared Element Names」を参照してください。
boundlist 必須です。 再定義された配列の各次元の境界を一覧表示します。

Remarks

ReDim ステートメントを使用し、既に宣言されている配列の 1 つまたは複数の次元のサイズを変更できます。 大きな配列があり、その要素の一部が必要ない場合、ReDim で配列のサイズを減らし、メモリを解放できます。 一方で、配列に要素を追加する必要がある場合、ReDim は要素を追加できます。

ReDim ステートメントは配列のみを対象としています。 スカラー (単一の値のみが含まれる変数)、コレクション、構造体では有効ではありません。 Array 型の変数を宣言する場合、ReDim ステートメントには新しい配列を作成するために十分な型情報が与えられません。

ReDim はプロシージャ レベルでのみ使用できます。 そのため、変数の宣言コンテキストはプロシージャにする必要があります。ソース ファイル、名前空間、インターフェイス、クラス、構造体、モジュール、ブロックにすることはできません。 詳細については、「宣言コンテキストと既定のアクセス レベル」を参照してください。

ルール

  • 複数の変数。 同じ宣言ステートメントで複数の配列変数のサイズを変更し、各変数の name 部分と boundlist 部分を指定できます。 複数の変数を指定するときは、コンマで区切ります。

  • 配列の境界。 boundlist の各エントリでその次元の上限と下限を指定できます。 下限は常に 0 (ゼロ) です。 上限は次元の長さ (上限に 1 を足したもの) ではなく、その次元で可能な最大インデックス値です。 各次元のインデックスは 0 ~ 上限値の範囲で変わります。

    boundlist の次元数は配列の次元の元の数 (r順位) に一致する必要があります。

  • データ型。 ReDim ステートメントでは、配列変数またはその要素のデータ型を変更できません。

  • 初期化。 ReDim ステートメントでは、配列要素の新しい初期化値を提供できません。

  • 順位。 ReDim ステートメントでは、配列の順位 (次元数) を変更できません。

  • Preserve によるサイズ変更。 Preserve を使用する場合、配列の最後の次元のサイズだけを変更できます。 他のすべての次元については、既存の配列の境界を指定する必要があります。

    たとえば、配列に次元が 1 つだけある場合、その次元のサイズを変更し、配列のすべてのコンテンツを保持できます。最後で唯一の次元を変更するためです。 ただし、配列に次元が 2 つ以上あるときは、Preserve を使用する場合、最後の次元だけのサイズを変更できます。

  • プロパティ。 値の配列を保持するプロパティで ReDim を使用できます。

動作

  • 配列の置換。 ReDim では既存の配列を解放し、同じ順位で新しい配列を作成します。 新しい配列は配列変数で解放された配列に取って代わります。

  • Preserve なしの初期化。 Preserve を指定しない場合、ReDim では、新しい配列の要素が、それらのデータ型の既定値を使用して初期化されます。

  • Preserve による初期化。 Preserve を指定する場合、Visual Basic では既存の配列から新しい配列に要素がコピーされます。

次の例では、配列の既存データを失うことなく動的配列の最後の次元のサイズを増やし、その後、一部のデータを損失しサイズを減らします。 最後に、サイズを減らして元の値に戻し、すべての配列要素を再初期化します。

Dim intArray(10, 10, 10) As Integer
ReDim Preserve intArray(10, 10, 20)
ReDim Preserve intArray(10, 10, 15)
ReDim intArray(10, 10, 10)

Dim ステートメントは次の 3 つの次元を持つ新しい配列を作成します。 各次元は 10 の境界で宣言されます。そのため、各次元の配列インデックスの範囲は 0 ~ 10 になります。 次の説明では、3 つの次元が「層」、「行」、「列」になります。

最初の ReDim は、変数 intArray の既存の配列を置換する新しい配列を作成します。 ReDim は既存の配列から新しい配列にすべての要素をコピーします。 また、さらに 10 個の列を各層の各行の終わりに追加し、これらの列の要素を 0 (配列の要素型である Integer の初期値) に初期化します。

2 番目の ReDim は新しい配列をもう 1 つ作成し、適合するすべての要素をコピーします。 ただし、5 つの列がすべての層のすべての行の終わりから失われます。 これらの列を使用して完了した場合、これは問題ではありません。 大きな配列のサイズを減らし、不要になったメモリを解放できます。

3 番目の ReDim は新しい配列をもう 1 つ作成し、すべての層のすべての行の終わりから別の 5 つの列を削除します。 このとき、既存の要素はコピーされません。 このステートメントは配列を元のサイズに戻します。 ステートメントに Preserve 修飾子が含まれないため、すべての配列要素が元の初期値に設定されます。

その他の例については、配列に関するページを参照してください。

関連項目