collection.max( )

4D v19.8

collection.max( )


collection.max ( {rotaProp} ) -> Resultado

Parâmetro	Tipo	Descrição
rotaProp	Texto	Rota da propriedade Objeto a ser usada para avaliação
Resultado	Booleano, Texto, Número, Collection, Objeto, Data	Valor máximo na coleção

Descrição

A função collection.max( ) devolve o elemento com o maior valor na coleção (o último elemento da coleção, já que se ordenaria em orden ascendente com o método collection.sort( )).

Nota: esta função não modifica a coleção original.

Se a coleção contiver diferentes tipos de valores, a função max( ) devolverá o valor máximo dentro do último tipo de elemento na ordem da lista de tipos (ver a descrição collection.sort( )).

Se a coleção contiver objetos, passe o parâmetro rotaProp para indicar a propriedade do objeto cujo valor máximo deseja obter.

Se a coleção estiver vazia, collection.max( ) devolve Undefined.

Exemplo

 C_COLLECTION($col)

 $col:=New collection(200;150;55)

 $col.push(New object("name";"Smith";"salary";10000))

 $col.push(New object("name";"Wesson";"salary";50000))

 $col.push(New object("name";"Alabama";"salary";10500))

 $max:=$col.max() //{name:Alabama,salary:10500}

 $maxSal:=$col.max("salary") //50000

 $maxName:=$col.max("name") //"Wesson"

Ver também

collection.min( )