collection.distinct( )

4D v19.8


collection.distinct ( {rotaProp}{;}{opção} ) -> Resultado

Parâmetro	Tipo	Descrição
rotaProp	Texto	Rota de atributo cujos valores você quer obter
opção	Inteiro longo	ck diacritical: avaliação diacrítica ("A" ≠ "a" por exemplo)
Resultado	Collection	Nova coleção apenas com valores diferentes

Descrição

O método collection.distinct( ) devolve uma coleção que contém só valores distintos (diferentes) da coleção original.

Nota: este método não modifica a coleção original.

A coleção devolvida se ordena automaticamente. Os valores Null não são devolvidos.

Se a coleção contiver objetos, pode passar o parâmetro rotaProp para indicar a propriedade do objeto cujos valores distintos deseja obter.

Como padrão, se realizar uma avaliação não diacrítica. Se quiser que a avaliação diferencie entre maiúsculas e minúsculas ou para diferenciar os caracteres acentuados, passe a constante ck diacritical no parâmetro opção.

Exemplo

 C_COLLECTION($c;$c2)

 $c:=New collection

 $c.push("a";"b";"c";"A";"B";"c";"b";"b")

 $c.push(New object("size";1))

 $c.push(New object("size";3))

 $c.push(New object("size";1))

 $c2:=$c.distinct() //$c2=["a","b","c",{"size":1},{"size":3},{"size":1}]

 $c2:=$c.distinct(ck diacritical) //$c2=["a","A","b","B","c",{"size":1},{"size":3},{"size":1}]

 $c2:=$c.distinct("size") //$c2=[1,3]