collection.map( )

4D v19.8

collection.map( )


collection.map ( nomMet {; param}{; param2 ; ... ; paramN} ) -> Resultado

Parámetro	Tipo	Descripción
nomMet	Texto	Nombre del método utilizado para transformar los elementos de la colección
param	Expresión	Parámetros para el método
Resultado	Collection	Colección de valores transformados

Descripción

El método collection.map( ) crea una nueva colección basada en el resultado de la llamada del método nomMet en cada elemento de la colección original. Opcionalmente, puede pasar parámetros a nomMet usando los parámetros param. collection.map( ) siempre devuelve una colección del mismo tamaño que la colección original.

nomMet recibe los siguientes parámetros:

en $1.value (todo tipo): valor del elemento a ser mapeado
en $2 (todo tipo): param
en $N... (todo tipo): param2...paramN

nomMet define los siguientes parámetros:

$1.result (todo tipo): nuevo valor transformado para agregar a la colección resultante
$1.stop (booleano): true para detener la retollamada del método. El valor devuelto es el último calculado.

Ejemplo

 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]

Este es el método Percentage:

 C_OBJECT($1)

 C_REAL($2)

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

Ver también

collection.extract( )