entitySelection.distinct( )

4D v19.8


entitySelection.distinct ( rotaAtributo {; opção} ) -> Resultado

Parâmetro	Tipo	Descrição
rotaAtributo	Texto	Rota de atributo cujos valores únicos deseja obter
opção	Inteiro longo	dk diacritical: avaliação diacrítica ("A" ≠ "a" por exemplo)
Resultado	Collection	Coleção apenas com valores diferentes

Descrição

O método entitySelection.distinct( ) retorna uma coleção que contém apenas valores diferentes da rotaAtributo na seleção de entidade.

A coleção retornada é automaticamente ordenada. Valores Null não são retornados.

Passe no parâmetro rotaAtributo os atributos de entidade cujos valores únicos você quer obter. Apenas valores escalares (texto, número, booleano ou data) podem ser usados. Se rotaAtributo for um atributo de objeto que contém valores de diferentes tipos, eles são primeiros agrupados por tipo e depois ordenados. Tipos são retornados na ordem abaixo:

booleanos
strings
números
datas

Como padrão, uma avaliação não diacrítica é realizada. Se quiser que a avaliação diferencie entre maiúsculas e minúsculas, e reconheça caracteres acentuados, passe a constante dk diacritical no parâmetro opção.

Um erro é retornado se:

rotaAtributo for um atributo relacionado,
rotaAtributo não for encontrado na classe de dados da seleção de entidade.

Exemplo

Se quiser obter uma coleção contendo um único elemento por nome de país:

 C_COLLECTION($countries)

 $countries:=ds.Employee.all().distinct("address.country")

Ver também

entitySelection.count( )