New shared collection

New shared collection {( ...value : any )} : Collection

引数	型		説明
value	Number, Text, Date, Time, Boolean, Shared object, Shared collection	→	共有コレクションの値
戻り値	Collection	←	New shared collection

説明

New shared collection コマンドは、空の、あるいは値が入った新規コレクションを作成し、その参照を返します。 Collections can be handled using properties and functions of the Collection class API.

Adding an element to this collection using the assignment operator must be surrounded by the Use...End use structure, otherwise an error is generated (this is not necessary when adding elements using functions such as push() or map() because they automatically trigger an internal Use...End use). ただし、属性の読み取りは Use...End use 構造の外側でも可能です。

info

For more information on shared collections, please refer to the Shared objects and collections page.

引数を渡さない場合、New shared collection は空のコレクションを作成し、その参照を返します。

返された参照は、コレクション型の 4D変数に代入する必要があります。

Keep in mind that var : Collection statement declares a variable of the Collection type but does not create any collection.

任意で、一つ以上の value 引数を渡すことで、あらかじめ値の入った新しい共有コレクションを作成することができます。 または、あとからオブジェクト記法による代入で要素を一つずつ追加・編集していくことができます (例題参照)。

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

以下のサポートされる型であれば、いくつでも値を渡すことができます:

• 数値 (実数、倍長整数...)。 数値は常に実数として保存されます。
• text
• boolean
• date
• 時間 (ミリ秒の数 (実数) として保存されます)。
• null
• 共有オブジェクト
• 共有コレクション

注

標準のコレクション (非共有コレクション) とは異なり、共有コレクションはピクチャーやポインター、共有でないオブジェクトおよびコレクションはサポートしていません。

例題

 $mySharedCol:=New shared collection("alpha";"omega")
 Use($mySharedCol)
    $mySharedCol[1]:="beta"
 End use

参照

New collection
New shared object
Shared objects and shared collections