Función SINGULAR

La función SINGULAR devuelve un valor BOOLEANO que indica si una lista contiene exactamente un elemento.

SINTAXIS

Si la lista especificada por ExpresiónLista contiene exactamente un elemento, SINGULAR devuelve TRUE. Si la lista contiene más o menos elementos, SINGULAR devuelve FALSE.

ExpresiónLista es cualquier expresión que devuelve una lista. Por ejemplo, todos los elementos siguientes devuelven una lista:
  • Un constructor LIST
  • Una referencia de campo con el indicador de matriz []
  • Algunas expresiones SELECT (no todas devuelven una lista)

Si sólo desea saber si una lista contiene exactamente un elemento u otra cantidad de elementos, SINGULAR se ejecuta más rápidamente que una expresión que implique la función CARDINALITY (por ejemplo, CARDINALITY(ExpresiónLista) = 1).

Una utilización común de esta función es determinar si un campo es exclusivo.

Ejemplos

-- Determinar si hay un solo campo F1 en el mensaje.
-- Observe que los corchetes [ ] son necesarios
DECLARE Field1Unique BOOLEAN SINGULAR(OutputRoot.XML.Data.Source.F1[]);
-- Determinar si hay un solo campo denominado F1 con el valor 'F12'
-- en el mensaje. Observe de nuevo que los corchetes [ ] son necesarios
DECLARE Field1F12Unique BOOLEAN
  SINGULAR(SELECT F.* FROM OutputRoot.XML.Data.Source.F1[] AS F where F = 'F12'); 
Conceptos relacionados
Visión general de ESQL
Tareas relacionadas
Desarrollo de ESQL
Referencia relacionada
Función CARDINALITY
Función EXISTS
Función THE
Diagramas de sintaxis: tipos disponibles
Funciones de lista ESQL
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
ak05585_