New shared collection

Home

4D v20 R7


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

Parameter	Typ	Beschreibung
Wert		Wert(e) von shared collection
Funktionsergebnis	Collection	Neue shared collection

Beschreibung

Die Funktion New shared collection erstellt eine neue leere oder vorab gefüllte shared collection und gibt ihre Referenz zurück. Fügen Sie dieser Collection ein Element hinzu, muss es in die Struktur Use...End use eingebettet werden, sonst wird ein Fehler erzeugt. Ein Element lesen ist dagegen ohne die Struktur Use...End use möglich.

Hinweis: Weitere Informationen dazu finden Sie auf der Seite Shared Objects und Shared Collections.

Übergeben Sie keine Parameter, erstellt New shared collection eine leere shared collection und gibt ihre Referenz zurück. Sie müssen diese Referenz einer 4D Variablen zuweisen, die mit dem Befehl _O_C_COLLECTION deklariert wurde.

Hinweis: Beachten Sie, dass _O_C_COLLECTION eine Variable vom Typ Collection deklariert, aber keine Collection erstellt.

Optional können Sie die neue shared collection vorab füllen, indem Sie einen oder mehrere Wert(e) als Parameter übergeben. Andernfalls können Sie Elemente danach über Zuweisen von Objektnotation hinzufügen oder ändern (siehe Beispiel).

Geht der neue Elementindex über das letzte Element in der shared collection hinaus, wird die Collection automatisch vergrößert und alle neu dazugekommenen Elemente erhalten den Wert Null.

Shared collection unterstützt Werte mit folgendem Typ:

Numerisch (Zahl, Lange Ganzzahl...) Zahlenwerte werden immer als Zahl gespeichert
Text
Boolean
Datum
Zeit (gespeichert als Anzahl Millisekunden - Zahl)
Null
shared object(*)
shared collection(*)

Hinweis: Im Gegensatz zu standardmäßigen Collections unterstützen shared collections weder Bilder oder Zeiger, noch not-shared objects/collections.

(*) Wird ein shared object/collection zu einer anderen shared collection hinzugefügt, teilen sie sich denselben Sperrschlüssel. Weitere informationen dazu finden Sie im Abschnitt Sperrschlüssel (Locking Identifier) - Wie shared groups funktioniert.

Beispiel

 $mySharedCol:=New shared collection("alpha";"omega")

 Use($mySharedCol)

    $mySharedCol[1]:="beta"

 End use

Siehe auch

New collection
New shared object
Shared Objects und Shared Collections