LIST TO ARRAY

LIST TO ARRAY ( list ; array {; itemRefs} )

引数	型		説明
list	Text, Integer	→	一番目の項目をコピーするコピー元のリスト
array	Array	←	コピー先の配列
itemRefs	Array	←	リスト項目の参照番号

説明

LIST TO ARRAY コマンドは、list で指定したリストまたは選択リストの第一レベルの項目で、配列arrayを作成または上書きします。

list 引数には、選択リストの名前(文字列)、または階層リストへの参照(ListRef)を渡すことが出来ます。

コピー先の配列を文字またはテキスト型として事前に設定をしていなかった場合、 LIST TO ARRAY は自動的に新しいテキスト配列をデフォルトで作成します。

注: コンパイルされたモードでは、array 引数の配列は事前に定義されている必要があり、型を変換することはできません。

オプションのitemRefs引数(数値配列)には、リスト項目の参照番号が返されます。

引き続き LIST TO ARRAY コマンドを使い、階層リストの第一レベル要素に基づく配列を構築できます。しかしこのコマンドは子項目を返しません。階層リストで作業する場合、階層リストコマンド、特に Load list の使用が推奨されます。

例題 1

以下の例は、リストRegionsの項目を配列atRegionsにコピーします:

 LIST TO ARRAY("Regions";atRegions)

例題 2

以下のように定義された階層リストについて考えます:

 myList2:=New list
 APPEND TO LIST(myList2;"Scotland";1)
 APPEND TO LIST(myList2;"England";2)
 APPEND TO LIST(myList2;"Wales";3)
 myList1:=New list
 APPEND TO LIST(myList1;"France";1)
 APPEND TO LIST(myList1;"Germany";2)
 APPEND TO LIST(myList1;"Spain";3)
 APPEND TO LIST(myList1;"Great Britain";4;myList2;True)
 APPEND TO LIST(myList1;"Portugal";5)
 APPEND TO LIST(myList1;"Belgium";6)
 APPEND TO LIST(myList1;"Italy";7)
 APPEND TO LIST(myList1;"Netherlands";8)
 APPEND TO LIST(myList1;"Ireland";9)

このリストは以下の様に表示されます:

これに対し以下の宣言を実行すると、:

 LIST TO ARRAY(myList1;$MyArray)

......結果は以下の様になります。

 $MyArray{1}="France"
 $MyArray{2}="Germany"
 $MyArray{3}="Spain"
 $MyArray{4}="Great Britain"
 $MyArray{5}="Portugal"
 ...

参照

ARRAY TO LIST
Load list
SAVE LIST

プロパティ

コマンド番号	288
スレッドセーフである	✗