4D v16.3

LIST TO ARRAY

Home

 
4D v16.3
LIST TO ARRAY

LIST TO ARRAY 


 

LIST TO ARRAY ( Liste ; ArrayName {; EintragRefs} ) 
Parameter Typ   Beschreibung
Liste  String, ListRef in Name oder Referenz der Liste, aus der Einträge der 1. Ebene zu kopieren sind
ArrayName  Array in Array, in das Einträge der Liste zu kopieren sind
EintragRefs  Array in Referenznummern für Einträge der Liste

Der Befehl LIST TO ARRAY erstellt oder überschreibt ArrayName mit den Einträgen der 1. Ebene aus Liste.

Im Parameter Liste können Sie entweder den Namen eine Auswahlliste (String) oder eine Referenz auf eine hierarchische Liste übergeben.

Haben Sie das Array zuvor nicht vom Typ Alphanumerisch oder Text definiert, erstellt LIST TO ARRAY standardmäßig ein Array vom Typ Text.

Hinweis: Im kompilierten Modus muss das Array Ziel vom gleichen Typ wie das Array Quelle sein.

Der Parameter EintragRefs ist optional (ein numerisches Array). Er gibt die Referenznummern für Einträge in der Auswahlliste zurück.

Mit LIST TO ARRAY können Sie ein Array mit Einträgen auf der 1. Ebene einer hierarchischen Liste erstellen. Sie können jedoch nicht mit untergeordneten Einträgen arbeiten. Wir empfehlen dazu, die Befehle für hierarchische Listen, insbesondere Load list zu verwenden.

Folgendes Beispiel kopiert die Einträge der Liste Regions in ein Array mit Namen atRegions:

 LIST TO ARRAY("Regions";atRegions)

Nehmen wir folgende hierarchische Liste:

 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)

Diese Liste könnte aussehen wie folgt:

Führen Sie folgende Anweisung aus:

 LIST TO ARRAY(myList1;$MyArray)

...erhalten Sie

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



Siehe auch 

ARRAY TO LIST
Load list
SAVE LIST

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Arrays
Nummer: 288

 
GESCHICHTE 

Erstellt: < 4D v6
Geändert: 4D v14

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v16)
4D Programmiersprache ( 4D v16.1)
4D Programmiersprache ( 4D v16.2)
4D Programmiersprache ( 4D v16.3)