LIST TO ARRAY

Home

4D v20.6

LIST TO ARRAY


LIST TO ARRAY ( Liste ; ArrayName {; EintragRefs} )

Parameter	Typ	Beschreibung
Liste	String, ListRef	Name oder Referenz der Liste, aus der Einträge der 1. Ebene zu kopieren sind
ArrayName	Array	Array, in das Einträge der Liste zu kopieren sind
EintragRefs	Array	Referenznummern für Einträge der Liste

Beschreibung

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.

Beispiel 1

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

LIST TO ARRAY("Regions";atRegions)

Beispiel 2

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