4D Doc Center : LIST TO ARRAY

4D v14.3

LIST TO ARRAY


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

引数	型	説明
list	文字, ListRef	一番目の項目をコピーするコピー元のリスト
array	配列	コピー先の配列
itemRefs	配列	リスト項目の参照番号

説明

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

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

コピー先の配列を文字またはテキスト型として事前に設定をしていなかった場合、 LIST TO 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"

 ...