entitySelection.distinct( )

4D v19.8


entitySelection.distinct ( rutaAtributo {; opcion} ) -> Resultado

Parámetro	Tipo	Descripción
rutaAtributo	Texto	Ruta de atributo cuyos distintos valores desea obtener
opcion	Entero largo	dk diacritical: evaluación diacrítica ("A" # "a" por ejemplo)
Resultado	Collection	Colección con valores diferentes únicamente

Descripción

El método entitySelection.distinct( ) devuelve una colección que contiene solo valores distintos (diferentes) de rutaAtributo en la selección de entidad.

La colección devuelta se ordena automáticamente. Los valores Null no son devueltos.

Pase en el parámetro rutaAtributo el atributo de entidad cuyos distintos valores desea obtener. Solo se pueden manejar valores escalares (texto, número, booleano o fecha). Si rutaAtributo es un atributo de objeto que contiene valores de diferentes tipos, primero se agrupan por tipo y se ordenan después. Los tipos se devuelven en el siguiente orden:

booleanos
cadenas
números
fechas

Por defecto, se realiza una evaluación no diacrítica. Si desea que la evaluación distinga entre mayúsculas y minúsculas o para diferenciar los caracteres acentuados, pase la constante dk diacritical en el parámetro opcion.

Se devuelve un error si:

rutaAtributo es un atributo relacionado,
rutaAtributo o se encuentra en la clase de datos de selección de entidad.

Ejemplo

Usted desea obtener una colección que contenga un solo elemento por nombre de país:

 C_COLLECTION($countries)

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

Ver también

entitySelection.count( )