collection.map( )

4D v19.8

collection.map( )


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

Parâmetro	Tipo	Descrição
nomeMet	Texto	Nome do método usado para transformar os elementos da coleção
param	Expression	Parâmetros do método
Resultado	Collection	Coleção de valores transformados

Descrição

O método collection.map( ) cria uma nova coleção baseada no resultado da chamada do método nomMet em cada elemento da coleção original. Opcionalmente, pode passar parâmetros a nomMet usando os parâmetros param. collection.map( ) sempre devolve uma coleção do mesmo tamanho que a coleção original.

nomMet recebe os parâmetros abaixo:

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

nomMet define os parâmetros abaixo:

$1.result (todo tipo): novo valor transformado para agregar à coleção resultante
$1.stop (booleano): true para deter a retrochamada do método. O valor devolvido for o último calculado.

Exemplo

 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 é o método Percentage:

 C_OBJECT($1)

 C_REAL($2)

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

Ver também

collection.extract( )