Dies ist die alte 4D Dokumentations-Website. Die neue und aktualisierte Dokumentation finden Sie unter developer.4d.com

Home

 
4D v19.8
collection.extract( )

collection.extract( ) 


 

collection.extract ( EigenschaftsPfad {; ZielPfad}{; EigenschaftsPfad2 ; ZielPfad2 ; ... ; EigenschaftsPfadN ; ZielPfadN}{; Option}) -> Funktionsergebnis 
Parameter Typ   Beschreibung
EigenschaftsPfad  Text in Eigenschaftspfad Objekt, dessen Werte für eine neue Collection entnommen werden
ZielPfad  Text in Ziel Eigenschaftspfad oder Eigenschaftsname
Option  Lange Ganzzahl in ck keep null: enthält Null oder undefinierte Eigenschaften in der zurückgegebenen Collection (wird standandmäßig ignoriert). Ist ZielPfad übergeben, wird dieser Parameter ignoriert.
Funktionsergebnis  Collection in Neue Collection mit den entnommenen Werten

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
Nummer: 805251

Dieser Befehl kann in preemptive Prozessen laufen

 
SEITENINHALT 
 
GESCHICHTE 

Erstellt: 4D v16 R6

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v19)
4D Programmiersprache ( 4D v19.1)
4D Programmiersprache ( 4D v19.4)
4D Programmiersprache ( 4D v19.5)
4D Programmiersprache ( 4D v19.6)
4D Programmiersprache ( 4D v19.7)
4D Programmiersprache ( 4D v19.8)