Funzione SINGULAR

La funzione SINGULAR restituisce un valore BOOLEAN che indica se un elenco contiene esattamente un elemento.

SINTASSI

Se l'elenco specificato da ListExpression contiene esattamente un elemento, SINGULAR restituisce TRUE. Se l'elenco contiene un numero maggiore o minore di elementi, SINGULAR restituisce FALSE.

ListExpression è una qualsiasi espressione che restituisce un elenco. Tutti gli elementi riportati di seguito, ad esempio, restituiscono un elenco:
  • Un costruttore LIST
  • Un riferimento di campo con l'indicatore di array []
  • Alcune espressioni SELECT (non tutte restituiscono un elenco)

Se si desidera solo sapere se un elenco contiene un solo elemento oppure un numero diverso di elementi, SINGULAR viene eseguita più rapidamente di un'espressione che utilizza la funzione CARDINALITY (ad esempio, CARDINALITY(ListExpression ) = 1).

Un utilizzo comune di questa funzione è quello di determinare se un campo è univoco.

Esempi

-- Determine whether there is just one F1 field in the message.
-- Note that the [ ] are required
DECLARE Field1Unique BOOLEAN SINGULAR(OutputRoot.XML.Data.Source.F1[]);
-- Determine whether there is just one field called F1 with the value 'F12'
-- in the message. Again note that the [ ] are required
DECLARE Field1F12Unique BOOLEAN
  SINGULAR(SELECT F.* FROM OutputRoot.XML.Data.Source.F1[] AS F where F = 'F12'); 
Concetti correlati
Panoramica di ESQL
Attività correlate
Sviluppo di ESQL
Riferimenti correlati
Funzione CARDINALITY
Funzione EXISTS
Funzione THE
Diagrammi di sintassi: tipi disponibili
Funzioni ESQL di elenco
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
ak05585_