4D v19

collection.extract( )

Home

 
4D v19
collection.extract( )

collection.extract( )  


 

Die Funktion collection.extract( ) erstellt und gibt eine neue Collection mit den Werten EigenschaftsPfad aus der ursprünglichen Collection mit Objekten zurück.

Hinweis: Diese Funktion ändert nicht die ursprüngliche Collection.

Der Inhalt der zurückgegebenen Collection richtet sich nach dem Parameter ZielPfad:

  • Ohne den Parameter ZielPfad füllt collection.extract( ) die neue Collection mit den Werten EigenschaftsPfad aus der ursprünglichen Collection.
    Standardmäßig werden Elemente, für die EigenschaftsPfad Null oder Undefiniert ist, in der resultierenden Collection ignoriert. Übergeben Sie die Konstante ck keep null im Parameter Option, werden diese Werte als Null Elemente in die zurückgegebene Collection übernommen.
  • Ist ein oder mehrere Parameter ZielPfad übergeben, füllt collection.extract( ) die neue Collection mit den Eigenschaften EigenschaftsPfad und jedes Element der neuen Collection ist ein Objekt mit ZielPfad Eigenschaften, gefüllt mit den entsprechenden Eigenschaften ZielPfad. Null Werte werden beibehalten (mit dieser Syntax wird der Parameter Option ignoriert).

 C_COLLECTION($c)
 $c:=New collection
 $c.push(New object("name";"Cleveland"))
 $c.push(New object("zip";5321))
 $c.push(New object("name";"Blountsville"))
 $c.push(42)
 $c2:=$c.extract("name") // $c2=[Cleveland,Blountsville]
 $c2:=$c.extract("name";ck keep null//$c2=[Cleveland,null,Blountsville,null]

 C_COLLECTION($c)
 $c:=New collection
 $c.push(New object("zc";35060))
 $c.push(New object("name";Null;"zc";35049))
 $c.push(New object("name";"Cleveland";"zc";35049))
 $c.push(New object("name";"Blountsville";"zc";35031))
 $c.push(New object("name";"Adger";"zc";35006))
 $c.push(New object("name";"Clanton";"zc";35046))
 $c.push(New object("name";"Clanton";"zc";35045))
 $c2:=$c.extract("name";"City") //$c2=[{City:null},{City:Cleveland},{City:Blountsville},{City:Adger},{City:Clanton},{City:Clanton}]
 $c2:=$c.extract("name";"City";"zc";"Zip") //$c2=[{Zip:35060},{City:null,Zip:35049},{City:Cleveland,Zip:35049},{City:Blountsville,Zip:35031},{City:Adger,Zip:35006},{City:Clanton,Zip:35046},{City:Clanton,Zip:35045}]



Siehe auch 

collection.map( )
entitySelection.extract

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Collections

Dieser Befehl kann in preemptive Prozessen laufen

 
SEITENINHALT 
 
GESCHICHTE 

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v19)
4D Programmiersprache ( 4D v19.1)