4D v12.4

ARRAY TO LIST

Home

 
4D v12.4
ARRAY TO LIST

 

ARRAY TO LIST 


 

ARRAY TO LIST ( ArrayName ; Liste {; itemRefs} ) 
Parameter Typ   Beschreibung
ArrayName  Array in Array, aus dem Array-Elemente zu kopieren sind
Liste  String in Liste, in die Array-Elemente zu kopieren sind
itemRefs  Array in Numerisches Array mit den Referenznummern der Items

Die Kompatibilität dieses Befehls ließ sich wegen der neu eingeführten Auswahllisten nicht voll erhalten. Von daher empfehlen wir, ab Version 6 den Befehl SAVE LIST zu verwenden und mit den hierarchischen Listen zu arbeiten, die in der Designumgebung im Listeneditor definiert sind.

Der Befehl ARRAY TO LIST erstellt oder ersetzt Liste (wie im Listeneditor der Designumgebung definiert) mit den Elementen von Array.
Der Befehl kann nur die Einträge der 1. Ebene in der Liste definieren.

Der Parameter itemRefs ist optional. Verwenden Sie ihn, muss er ein numerisches Array sein, das mit Array synchronisiert ist. Jedes Element gibt dann die Referenznummer der Einträge aus der Liste für das entsprechende Element in Array an. Verwenden Sie ihn nicht, setzt 4D automatisch die Referenznummer der Items aus der Liste auf 1, 2... N.

Hinweis zur Kompatibilität: In vorherigen Versionen von 4D ließen sich über diesen Parameter andere Listen mit jedem Element in Array verknüpfen. War ein Element des Array Verknüpfung der Name einer vorhandenen Liste, wurde diese an den entsprechenden Eintrag angehängt.

Mit ARRAY TO LIST können Sie weiterhin eine Liste mit den Elementen eines Array erstellen. Sie erhalten jedoch keine untergeordneten Einträge, sofern vorhanden. Verwenden Sie dafür die in Version 6 neu eingeführten Befehle für hierarchische Listen.

Folgendes Beispiel kopiert das Array atRegions in die Liste mit Namen “Regions:”

 ARRAY TO LIST(atRegions;"Regions")

Der Fehler -9957 tritt auf, wenn ARRAY TO LIST auf eine Liste angewendet wird, die gerade in der Designumgebung im Listeneditor angelegt wird. Sie können diesen Fehler mit einer Projektmethode ON ERR CALL abfangen.

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Arrays
Nummer: 287

Dieser Befehl ändert die Systemvariable Error

 
GESCHICHTE 

Erstellt: < 4D v6

 
SIEHE AUCH 

LIST TO ARRAY
Load list
ON ERR CALL
SAVE LIST