WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Função CARDINALITY

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

Sintaxe

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>-CARDINALITY--(--ListExpression--)---------------------------><

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.XMLNS.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.XMLNS.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
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:29:57


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | ak05530_