CARDINALITY-Funktion

Die Funktion CARDINALITY gibt die Anzahl von Elementen in einer Liste zurück.

SYNTAX

CARDINALITY gibt einen ganzzahligen Wert zurück, der die Anzahl der Elemente in de Liste nennt, die von ListExpression angegeben wird.

ListExpression kann jeder Ausdruck sein, der eine Liste zurückgibt. Folgende Elemente geben z. B. eine Liste zurück:
  • Ein LIST-Konstruktor
  • Ein Feldverweis mit dem Array-Anzeiger []
  • Einige SELECT-Ausdrücke (nicht alle geben eine Liste zurück)

Häufig dient diese Funktion zur Festlegung der Anzahl der Felder in einer Liste, bevor über sie iteriert wird.

Beispiele

-- Anzahl von F1-Feldern in der Nachricht festlegen.
-- [ ] sind erforderlich.
DECLARE CountF1 INT CARDINALITY(OutputRoot.XML.Data.Source.F1[]);
-- Anzahl von F1-Feldern in der Nachricht mit dem Wert 'F12' festlegen.
-- Auch hier sind [ ] erforderlich
DECLARE CountF1F12 INT     
  CARDINALITY(SELECT F.* FROM OutputRoot.XML.Data.Source.F1[] AS F where F = 'F12'); 
-- Verweisen Sie mit dem von CARDINALITY zurückgegebenen Wert auf ein bestimmtes Element
-- in einer Liste oder einer Feldgruppe:
-- Da Feldgruppenindizes bei 1 beginnen, verweist dieses Beispiel auf die drittletzte
-- Instanz des Feldes 'Item'.
Body.Invoice.Item[CARDINALITY(Body.Invoice.Item[]) - 2].Quantity
Zugehörige Konzepte
Übersicht zu ESQL
Zugehörige Tasks
ESQL erstellen
Zugehörige Verweise
EXISTS-Funktion
SINGULAR-Funktion
Funktion THE
Syntaxdiagramme: verfügbare Typen
ESQL-Listenfunktionen
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
ak05530_