4D v14.3

LIST TO ARRAY

ホーム

 
4D v14.3
LIST TO ARRAY

LIST TO ARRAY 


 

LIST TO ARRAY ( list ; array {; itemRefs} ) 
引数   説明
list  文字, ListRef in 一番目の項目をコピーするコピー元のリスト
array  配列 in コピー先の配列
itemRefs  配列 in リスト項目の参照番号

説明   

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

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

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

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

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

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

 LIST TO ARRAY("Regions";atRegions)

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

 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"
 ...

 
プロパティ 

プロダクト: 4D
テーマ: 配列
番号: 288

 
履歴 

New
初出: < 4D v6
変更: 4D v14

 
参照 

ARRAY TO LIST
Load list
SAVE LIST

 
ARTICLE USAGE

ランゲージリファレンス ( 4D v14 R2)
ランゲージリファレンス ( 4D v14 R3)
ランゲージリファレンス ( 4D v14.3)
ランゲージリファレンス ( 4D v14 R4)

Inherited from : LIST TO ARRAY ( 4D v11 SQL Release 6)