New collection

Home

4D v20 R7

New collection


New collection {( Wert {; Wert2 ; ... ; WertN} )} -> Funktionsergebnis

Parameter	Typ	Beschreibung
Wert	Zahl, Text, Datum, Objekt, Collection, Zeiger	Wert der Collection
Funktionsergebnis	Collection	Neue Collection

Beschreibung

Die Funktion New collection erstellt eine neue leere oder vorgefüllte Collection und gibt ihre Referenz zurück.

Übergeben Sie keine Parameter, erstellt New collection eine leere Collection und gibt ihre Referenz zurück.

Sie müssen die zurückgegebene Referenz einer 4D Variablen übergeben, die mit _O_C_COLLECTION deklariert wurde.

Hinweis: Beachten Sie, dass _O_C_COLLECTION eine Variable vom Typ Collection deklariert, jedoch keine Collection anlegt.

Optional können Sie die neue Collection vorab füllen, indem Sie als Parameter einen oder mehrere Wert(e) übergeben.

Andernfalls können Sie durch Zuweisung der Objektnotation Elemente in Folge hinzufügen oder ändern, wie zum Beispiel:

myCol[10]:="My new element"

Geht der neue Element Index über das letzte vorhandene Element der Collection hinaus, wird die Collection automatisch angepasst und alle neuen Zwischenelemente erhalten den Wert Null.

Hinweis: Weitere Informationen dazu finden Sie im Abschnitt Objektnotation verwenden.

Sie können beliebig viele Werte der unterstützten Typen übergeben, wie Zahl, Text, Datum, Zeiger, Objekt, Collection, etc. Im Gegensatz zu Arrays können Collections unterschiedliche Typen von Daten miteinander mischen.

Beim Konvertieren müssen Sie auf folgendes achten:

Übergeben Sie einen Zeiger, bleibt er unverändert; er wird mit dem Befehl JSON Stringify bewertet.
Datumsangaben werden als Datumsformat "yyyy-mm-dd" oder als Zeichenkette "YYYY-MM-DDTHH:mm:ss.SSSZ" gespeichert, gemäß der aktuellen Datenbank-Eigenschaft für Datum innerhalb von Objekten (siehe Seite Kompatibilität). Wird ein 4D Datum vor dem Speichern in der Collection in Text konvertiert, berücksichtigt das Programm standardmäßig die lokale Zeit. Sie können dieses Verhalten mit dem Selektor JSON use local time des Befehls SET DATABASE PARAMETER verändern.
Übergeben Sie eine Zeit, wird sie als eine Zahl in Millisekunden gespeichert (Real).

Beispiel 1

Eine neue leere Collection erstellen und diese einer 4D Collection Variable zuweisen:

 C_COLLECTION($myCol)

 $myCol:=New collection

  //$myCol=[]

Beispiel 2

Eine vorgefüllte Collection erstellen:

 C_COLLECTION($filledColl)

 $filledColl:=New collection(33;"mike";"november";->myPtr;Current date)

  //$filledColl=[33,"mike","november",->myPtr,2017-03-28T22:00:00.000Z]

Beispiel 3

Eine neue Collection anlegen und dann ein neues Element hinzufügen:

 C_COLLECTION($coll)

 $coll:=New collection("a";"b";"c")

  //$coll=["a","b","c"]

 $coll[9]:="z" //10. Element mit Wert "z" hinzufügen

 $vcolSize:=$coll.length //10

  //$coll=["a","b","c",null,null,null,null,null,null,"z"]

Hinweis: Für dieses Beispiel muss die Objekt Notation in den Struktureinstellungen aktiviert sein. (siehe Abschnitt Objektnotation).

Siehe auch

C_COLLECTION
New shared collection
Type