Funzione CARDINALITY

La funzione CARDINALITY restituisce il numero di elementi in un elenco.

SINTASSI

CARDINALITY restituisce un valore integer che indica il numero di elementi nell'elenco specificato da ListExpression.

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)

Un utilizzo comune di questa funzione è quello di determinare il numero di campi in un elenco prima di un'iterazione.

Esempi

-- Determine the number of F1 fields in the message.
-- Note that the [ ] are required   
DECLARE CountF1 INT CARDINALITY(OutputRoot.XML.Data.Source.F1[]);
-- Determine the number of fields called F1 with the value 'F12' in the message.
-- Again note that the [ ] are required
DECLARE CountF1F12 INT     
  CARDINALITY(SELECT F.* FROM OutputRoot.XML.Data.Source.F1[] AS F 
              where F = 'F12');
-- Use the value returned by CARDINALITY to refer to a specific element 
-- in a list or array:
-- Array indices start at 1, so this example refers to the third-from-last
-- instance of the Item field
Body.Invoice.Item[CARDINALITY(Body.Invoice.Item[]) - 2].Quantity
Concetti correlati
Panoramica di ESQL
Attività correlate
Sviluppo di ESQL
Riferimenti correlati
Funzione EXISTS
Funzione SINGULAR
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
ak05530_