配列
配列 とは、同じタイプの 変数 を番号付きで並べたものです。 各変数は、配列の 要素 といいます。 配列のサイズとは、配列が持つ要素の数を指します。配列は作成時にサイズが与えられ、要素の追加・挿入・削除によって、または作成時に使用したコマンドの再使用によって、何度でもサイズを変更することができます。 配列要素には、1 から N の番号が付けられます (N は配列のサイズ)。 配列は必ず、特別な 要素ゼロ を持ちます。 配列は 4D の変数です。 他の変数と同様、配列にもスコープがあり、4D ランゲージの規則に従いますが、他と異なるところがいくつかあります。
ほとんどの場合において、配列 より コレクション の利用が推奨されます。 コレクションは配列より柔軟なだけでなく、たくさんの専用メソッドを持ちます。 詳細については、コレクション を参照してください。
配列の作成
配列は、"配列" テーマの配列宣言コマンドのいずれかを使用して作成します。 配列宣言コマンドは、1次元または 2次元の配列の作成やサイズ変更をすることができます。 2次元配列の詳細については 二次元配列 を参照してください。
次のコードは、10個の要素からなる整数配列を作成 (宣言) します:
ARRAY INTEGER(aiAnArray;10)
次のコードは、さきほど作成した配列を20要素にサイズ変更します:
ARRAY INTEGER(aiAnArray;20)
次のコードは、この配列を要素なしにサイズ変更します:
ARRAY INTEGER(aiAnArray;0)
配列要素への値の代入
配列中の要素は中カッコ ({…}) を使用して参照します。 中カッコの中には数字を入れて特定の要素を指定します。この数字を要素番号といいます。 次のコードは、5つの名前を atNames という配列に入れ、それらを警告ウィンドウに表示します:
ARRAY TEXT(atNames;5)
atNames{1}:="Richard"
atNames{2}:="Sarah"
atNames{3}:="Sam"
atNames{4}:="Jane"
atNames{5}:="John"
For($vlElem;1;5)
ALERT("要素番号 #"+String($vlElem)+" の値は "+atNames{$vlElem}+" です。")
End for
atNames{$vlElem} というシンタックスに注目してください。 atNames{3} のように数値リテラルを使うだけでなく、数値変数によって配列の要素番号を指定することができます。 ループ構造による反復を使用すると (For...End for
, Repeat...Until
または While...End while
)、短いコードで配列の全要素、または一部の要素を対象とした処理をおこなうことができます。
重要: 代入演算子 (:=) と比較演算子 (=) とを混同しないように注意してください。 代入と比較は、まったく異なった性質の処理です。
配列への配列の代入
文字列やテキスト変数と違って、配列に配列を代入することはできません。 配列をそっくりそのまま別の配列にコピーするには COPY ARRAY
コマンドを使います。
配列の要素ゼロ
配列は必ず、要素ゼロを持ちます。 ドロップダウンリストなどのフォームオブジェクトに配列が設定されていた場合、要素ゼロが表示されることはありませんが、ランゲージでの利用に制限はありません (*)。
例として、デフォルト値を指定せずにフォームオブジェクトを初期化したいとします。 このような場合に配列の要素ゼロが利用できます:
// atName 配列と紐づいているコンボボックスまたはドロップダウンリストの
// フォームオブジェクトメソッドです
Case of
:(Form event code=On Load)
// 要素ゼロを含め
// 配列を初期化します
ARRAY TEXT(atName;5)
atName{0}:=選択してください"
atName{1}:="Text1"
atName{2}:="Text2"
atName{3}:="Text3"
atName{4}:="Text4"
atName{5}:="Text5"
// 配列の選択要素を要素ゼロに設定します
atName:=0
End case
(*) ひとつだけ例外があります。配列タイプのリストボックスでは、編集中の元の値を保持するため、内部的に配列の要素ゼロが使用されます。この特別なケースでは、開発者は 0番目の要素を利用できません。
二次元配列
配列宣言コマンドはそれぞれ、1次元および 2次元の配列を作成、またはサイズ変更ができます。 例:
ARRAY TEXT(atTopics;100;50) // 100行と 50列からなるテキスト配列を作成します