4D Doc Center : LIST TO ARRAY

Home

4D v14.3

LIST TO ARRAY


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

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

Der Parameter itemRefs 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"

 ...