entitySelection.distinct( )

4D v19.8


entitySelection.distinct ( cheminAttribut {; option} ) -> Résultat

Paramètre	Type	Description
cheminAttribut	Texte	Chemin de l'attribut dont vous souhaitez les valeurs distinctes
option	Entier long	dk diacritical : évaluation diacritique ("A" # "a" par exemple)
Résultat	Collection	Collection avec seulement les valeurs distinctes

Description

La méthode entitySelection.distinct( ) renvoie une collection contenant uniquement les valeurs distinctes (différentes) de cheminAttribut dans la sélection d'entités.

La collection retournée est automatiquement triée. Les valeurs Null ne sont pas renvoyées.

Dans le paramètre cheminAttribut, passez l'attribut d'entité dont vous voulez obtenir les valeurs distinctes. Seules les valeurs scalaires (texte, nombre, booléen ou date) peuvent être gérées. Si cheminAttribut est un attribut d'objet qui contient des valeurs de types différents, elles sont groupées par type et triées ensuite. Les types sont renvoyés dans l'ordre suivant :

booléens
chaînes
nombres
dates

Par défaut, une évaluation non diacritique est effectuée. Si vous souhaitez que l'évaluation soit sensible à la casse ou pour différencier des caractères accentués et non-accentués, passez la constante dk diacritical dans le paramètre option.

Une erreur est retournée si :

cheminAttribut est un attribut relationnel,
cheminAttribut n'est pas trouvé dans la sélection d'entités de la dataclass.

Exemple

Vous souhaitez obtenir une collection contenant un élément par nom de pays :

 C_COLLECTION($countries)

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

Voir aussi

entitySelection.count( )