バージョン: 20 R7 BETA

コレクション

コレクションとは、類似または混在した型 (テキスト、数値、日付、オブジェクト、ブール、コレクション、null) の値が順番に並べられたリストです。

コレクション型の変数を扱うには、オブジェクト記法を使用します。

コレクション要素にアクセスするには、大カッコ内に要素番号を渡します:

collectionRef[expression]

expression には正の整数を返す有効な 4D 式であればどんなものでも渡すことができます。例:

 myCollection[5]  // コレクションの 6番目の要素にアクセス
 myCollection[$var]

注: コレクション要素は 0番から始まるということに注意してください。

コレクションの要素に値を代入したり、コレクション要素の値を取得したりすることができます:

 myCol[10]:="My new element"
 $myVar:=myCol[0]

コレクションの最後の要素を超える要素番号 (インデックス) を指定した場合、コレクションは自動的にリサイズされ、途中のすべての値には null 値が割り当てられらます:

 var myCol : Collection
 myCol:=New collection("A";"B")
 myCol[5]:="Z"
  //myCol[2]=null
  //myCol[3]=null
  //myCol[4]=null

インスタンス化

コレクションはあらかじめインスタンス化しておく必要があります。初期化しない場合、要素の取得や変更はシンタックスエラーとなります。

コレクションのインスタンス化は、以下のいずれかの方法でおこなうことができます:

New collection コマンドを使用する。
[] 演算子を使用する。

info

いくつかの 4Dコマンドや関数はコレクションを返します。たとえば、 Monitored Activity や collection.copy などです。この場合、コレクションを明示的にインスタンス化する必要はなく、4Dランゲージが代わりにおこなってくれます。

`New collection` コマンド

New collection コマンドは、空の、あるいは値の入った新規コレクションを作成し、その参照を返します。

例:

 var $colVar : Collection // コレクション型 4D変数の宣言
 $colVar:=New collection // コレクションのインスタンス化と 4D変数への代入

 var $colFilled : Collection
 $colFilled:=New collection("a";"b";1;42;{}) // 値の入ったコレクションのインスタンス化と変数への代入

`[]` 演算子

[] 演算子を使って、コレクションリテラル を作成することができます。コレクションリテラルとは、コレクション要素を表す式が 0個以上含まれたセミコロン区切りのリストを大括弧 [] で囲んだものです。コレクションリテラルを使ってコレクションを作成すると、指定された値を要素としてインスタンス化され、その長さは指定された要素の数になります。

要素は式とみなされるため、要素に [] を使ってサブコレクションを作成することができます。また、オブジェクトリテラル を作成し、参照することもできます。

要素が未定義の場合、コレクションにおいては Null となります。

例:

var $col1; $col2; $users : Collection
$col1:=[] // 空のコレクション
$col2:=[1;2;3;4;5;6] // 数値のコレクション
// オブジェクトのコレクション
$users:=[{name: "Alice"; \
	height: 183; \
	eyecolor: "hazel"; \
	id: $col2[5]\
	}; \
	{name: "Bob"; \
	height: 172; \
	eyecolor: "blue"\
	}]

注

要素を 1つだけ含むコレクションリテラルを作成する場合、既存のテーブル名に対応する文字列を使用することはできません。競合が発生した場合、テーブルシンタックス [tableName] が優先されます。

通常コレクションと共有コレクション

二種類のコレクションを作成することができます:

New collection コマンド、またはコレクションリテラルのシンタックス [] を使用して作成する通常 (非共有) コレクション。通常のコレクションは特別なアクセスコントロールをせずに編集可能ですが、プロセス間で共有することはできません。
New shared collection コマンドを使用して作成する共有コレクション。共有コレクションはプロセス間 (プリエンティブ・スレッド含む) で共有可能なコレクションです。共有コレクションへのアクセスは Use...End use 構造によって管理されています。

詳細な情報については、共有オブジェクトと共有コレクションを参照ください。