Função CARDINALITY

A função CARDINALITY retorna o número de elementos em uma lista.

SINTAXE

CARDINALITY retorna um valor inteiro que fornece o número de elementos na lista especificada por ListExpression.

ListExpression é qualquer expressão que retorne uma lista. Por exemplo, todos a seguir retornam uma lista:
  • Um construtor LIST
  • Uma referência de campo com o indicador de matriz []
  • Algumas expressões SELECT (em todas retornam uma lista)

Um uso comum dessa função é determinar o número de campos em uma lista antes de iterá-los.

Exemplos

-- Determinar o número de campos F1 na mensagem.
-- Observe que os [ ] são requeridos
DECLARE CountF1 INT CARDINALITY(OutputRoot.XML.Data.Source.F1[]);
-- Determinar o número de campos chamados F1 com o valor 'F12' na mensagem.
-- Novamente, observe que os [ ] são requeridos
DECLARE CountF1F12 INT
  CARDINALITY(SELECT F.* FROM OutputRoot.XML.Data.Source.F1[] AS F
              where F = 'F12');
-- Utilize o valor retornado por CARDINALITY para referir-se a um elemento específico
-- em uma lista ou matriz:
-- Os índices de matriz iniciam com 1, portanto, este exemplo refere-se à antepenúltima
-- instância do campo Item
Body.Invoice.Item[CARDINALITY(Body.Invoice.Item[]) - 2].Quantity
Conceitos relacionados
Visão Geral do ESQL
Tarefas relacionadas
Desenvolvendo ESQL
Referências relacionadas
Função EXISTS
Função SINGULAR
Função THE
Diagramas de Sintaxe: Tipos Disponíveis
Funções da Lista ESQL
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
ak05530_