DISTINCT ATTRIBUTE VALUES

4D v16.3


DISTINCT ATTRIBUTE VALUES ( campoObjeto ; ruta ; arrayValores )

Parámetro	Tipo	Descripción
campoObjeto	Campo	Campo de objeto del que desea obtener la lista de valores de atributos distintos
ruta	Texto	Ruta de acceso del atributo cuyos valores distintos desea obtener
arrayValores	Array texto, Array entero largo, Array booleano, Array fecha, Time array	Valores distintos en la ruta de atributos

Descripción

Tema: Arrays

El comando DISTINCT ATTRIBUTE VALUES crea y llena el arrayValores con valores no repetidos (únicos) procedentes del atributo ruta en el campo campoObjeto para la selección actual de la tabla a la que pertenece el campo. Si campoObjeto no es un campo de objeto indexado, se devuelve un error.

Pase en ruta una ruta atributo válida. Utilice la notación punto estándar para definir rutas a atributos anidados, por ejemplo "empresa.direccion.numero". Tenga en cuenta que los nombres de atributos objeto son sensibles a las mayúsculas y minúsculas.

El array que pasó en arrayValores debe ser del mismo tipo que el atributo ruta pasado como parámetro, de lo contrario el array se vuelve a digitar. Sólo se admiten los siguientes tipos de arrays: numérico, texto, fecha y hora (los valores deben ser escalar: punteros, objetos, blobs o imágenes no son soportados).

Después de la llamada, el tamaño del array es igual al número de valores distintos que se encuentran en la selección. El comando no cambia la selección actual o el registro actual.

Utilización de la propiedad virtual .length

Puede utilizar la propiedad virtual "longitud" con este comando. Está disponible automáticamente para todos los atributos de tipo array, y ofrece el tamaño del array, es decir, el número de elementos que contiene. Esta propiedad está diseñada para ser utilizada en búsquedas (ver QUERY BY ATTRIBUTEQUERY BY ATTRIBUTE). También se puede utilizar con el comando DISTINCT ATTRIBUTE VALUES para obtener los diferentes tamaños de array para un atributo.

Ejemplo

Su base contiene un campo objeto [Customer]full_Data (indexado) con 12 registros:

Si ejecuta este código:

 ARRAY LONGINT(aLAges;0)

 ALL RECORDS([Customer])

  //get the distinct values for the "age" attibute

 DISTINCT ATTRIBUTE VALUES([Customer]full_Data;"age";aLAges)

El array aLAges obtiene los siguientes 9 elementos:

  //aLAges{1}=33

  //aLAges{2}=35

  //aLAges{3}=36

  //aLAges{4}=40

  //aLAges{5}=42

  //aLAges{6}=44

  //aLAges{7}=52

  //aLAges{8}=54

  //aLAges{9}=60

Ver también

DISTINCT ATTRIBUTE PATHS