Dies ist die alte 4D Dokumentations-Website. Die neue und aktualisierte Dokumentation finden Sie unter developer.4d.com |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v19.8
collection.extract( )
|
collection.extract ( EigenschaftsPfad {; ZielPfad}{; EigenschaftsPfad2 ; ZielPfad2 ; ... ; EigenschaftsPfadN ; ZielPfadN}{; Option}) -> Funktionsergebnis | ||||||||
Parameter | Typ | Beschreibung | ||||||
EigenschaftsPfad | Text |
![]() |
Eigenschaftspfad Objekt, dessen Werte für eine neue Collection entnommen werden | |||||
ZielPfad | Text |
![]() |
Ziel Eigenschaftspfad oder Eigenschaftsname | |||||
Option | Lange Ganzzahl |
![]() |
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 |
![]() |
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:
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}]
Produkt: 4D
Thema: Collections
Nummer:
805251
Erstellt: 4D v16 R6
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)