Función SINGULAR

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

Sintaxis

Leer el esquema de sintaxisOmitir el esquema de sintaxis visual
>>-SINGULAR--(--ExpresiónLista--)------------------------------><

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 una expresión que devuelve una lista. Por ejemplo, todas las expresiones 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 desea saber únicamente si una lista contiene exactamente un elemento u otro número 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).

Un uso típico de esta función es el de 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.XMLNS.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.XMLNS.Data.Source.F1[] AS F where F = 'F12'); 
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        Última actualización
        
        Última actualización : 2013-02-27 18:24:18


Tema de referenciaTema de referencia | Versión 8.0.0.2 | ak05585_