collection.map( )

Home

4D v19.8

collection.map( )


collection.map ( MethodenName {; param}{; param2 ; ... ; paramN} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
MethodenName	Text	Name der Methode zum Umwandeln der Collection Elemente
param	Ausdruck	Parameter für die Methode
Funktionsergebnis	Collection	Collection der umgewandelten Werte

Beschreibung

Die Funktion collection.map( ) erstellt eine neue Collection, basierend auf dem Ergebnis der aufgerufenen Funktion MethodenName für jedes Element der ursprünglichen Collection. Optional können Sie über param Parameter an MethodenName übergeben. collection.map( ) gibt immer eine Collection mit derselben Größe wie die ursprüngliche Collection zurück.

MethodenName empfängt folgende Parameter:

In $1.value (beliebiger Typ): Abzubildender Elementwert
In $2 (beliebiger Typ): param
In $N... (beliebiger Typ): param2...paramN

MethodenName setzt folgende Parameter:

$1.result (beliebiger Typ): Neuer umgewandelter Wert zum Hinzufügen in der resultierenden Collection
$1.stop (Boolean): wahr, um Aufruf der Methode zu stoppen. Der zurückgegebene Wert ist der letzte berechnete Wert.

Beispiel

 C_COLLECTION($c;$c2)

 $c:=New collection(1;4;9;10;20)

 $c2:=$c.map("Percentage";$c.sum())

  //$c2=[2.27,9.09,20.45,22.73,45.45]

Hier ist die Methode Percentage:

 C_OBJECT($1)

 C_REAL($2)

 $1.result:=Round(($1.value/$2)*100;2)

Siehe auch

collection.extract( )