COLLECTION TO ARRAY

Home

4D v20 R7

COLLECTION TO ARRAY


COLLECTION TO ARRAY ( collection ; Array {; EigenschaftenName}{; Array2 ; EigenschaftenName2 ; ... ; ArrayN ; EigenschaftenNameN} )

Parameter	Typ	Beschreibung
collection	Collection	Collection zum Kopieren in Array(s)
Array	Array	Array zum Empfangen der Elemente der Collection; ist EigenschaftenName definiert, zum Empfangen der Werte von EigenschaftenName in der Collection
EigenschaftenName	Text	Name der Objekteigenschaft, dessen Werte in Array kopiert werden sollen ("" für alle Elemente)

Beschreibung

Der Befehl COLLECTION TO ARRAY füllt ein oder mehrere Array(s) mit Elementen oder Werten von EigenschaftenName von Collection in Array(s).

COLLECTION TO ARRAY kann mit einer Collection mit Werten oder einer Collection mit Objekten arbeiten. Im zweiten Fall sind der/die Parameter EigenschaftenName zwingend.

Ohne den Parameter EigenschaftenName kopiert der Befehl alle Elemente von Collection in Array. Anschließend ist die Größe von Array identisch mit der Länge von Collection.
Übergeben Sie einen oder mehrere Parameter EigenschaftenName, muss Collection eine Collection von Objekten sein (andere Elemente werden ignoriert). In diesem Fall gibt jeder Parameter EigenschaftenName den Namen einer Eigenschaft innerhalb jedes Objekts der Collection an, deren Wert(e) in das entsprechende Array kopiert werden soll(en). Sie können beliebige Paare EigenschaftenName / Array und unterschiedliche Arraytypen übergeben. Anschließend ist jede Größe von Array identisch mit der Länge von Collection.

In allen Fällen konvertiert 4D die Elemente oder Werte der Collection gemäß dem Typ von Array (falls erforderlich). Weitere Informationen zu den Regeln beim Konvertieren finden Sie auf der Seite Typkonvertierung zwischen Collections und 4D Arrays.

Beispiel 1

Eine Collection von Strings in ein Text Array kopieren:

 C_COLLECTION($fruits)

 $fruits:=New collection("Orange";"Banane";"Apfel";"Traube")

 ARRAY TEXT($artFruits;0)

 COLLECTION TO ARRAY($fruits;$artFruits)

  //$artFruits{1}="Orange"

  //$artFruits{2}="Banane"

  //...

Beispiel 2

Unterschiedliche Eigenschaftenwerte aus einer Collection von Objekten in verschiedene Arrays kopieren:

 C_COLLECTION($col)

 $col:=New collection

 ARRAY TEXT($city;0)

 ARRAY LONGINT($zipCode;0)

 $col.push(New object("name";"Cleveland";"zc";35049))

 $col.push(New object("name";"Blountsville";"zc";35031))

 $col.push(New object("name";"Adger";"zc";35006))

 $col.push(New object("name";"Clanton";"zc";35046))

 $col.push(New object("name";"Shelby";"zc";35143))

 

 COLLECTION TO ARRAY($col;$city;"name";$zipCode;"zc")

  //$city{1}="Cleveland", $zipCode{1}=35049

  //$city{2}="Blountsville", $zipCode{2}=35031

  //...

Siehe auch

ARRAY TO COLLECTION
Typkonvertierung zwischen Collections und 4D Arrays