Función CARDINALITY

La función CARDINALITY devuelve el número de elementos en una lista.

Sintaxis

Formato del diagrama de sintaxis      Diagrama de vía      Decimal con puntos

CARDINALITY devuelve un valor entero que proporciona el número de elementos en la lista especificada mediante ExpresiónLista.

ExpresiónLista es cualquier expresión que devuelve una lista. Por ejemplo, todos los elementos siguientes devuelven una lista:
  • Un constructor LIST
  • Una referencia de campo con el indicador de matriz []
  • Algunas expresiones SELECT (no todas devuelven una lista)

Una utilización común de esta función es determinar el número de campos en una lista, antes de repetir sobre ellos.

Ejemplos

-- Determinar el número de campos F1 en el mensaje.
-- Observe que los corchetes [ ] son necesarios   
DECLARE CountF1 INT CARDINALITY(OutputRoot.XMLNS.Data.Source.F1[]);
-- Determinar el número de campos denominados F1 con el valor 'F12' en el mensaje.
-- Observe de nuevo que los corchetes [ ] son necesarios
DECLARE CountF1F12 INT     
  CARDINALITY(SELECT F.* FROM OutputRoot.XMLNS.Data.Source.F1[] AS F 
              where F = 'F12');
-- Utilizar el valor devuelto por CARDINALITY para hacer referencia a 
-- un elemento específico en una lista o matriz:
-- Los índices de la matriz empiezan por 1, por lo que este ejemplo hace
--  referencia a la antepenúltima instancia del campo Item
Body.Invoice.Item[CARDINALITY(Body.Invoice.Item[]) - 2].Quantity
Avisos | Marcas registradas | Este enlace se abre en una nueva ventana Descargas | Este enlace se abre en una nueva ventana Biblioteca | Este enlace se abre en una nueva ventana Soporte | Comentarios

Copyright IBM Corporation 1999, 2011Copyright IBM Corporation 1999, 2011.

        
        Última actualización
        
        Última actualización : 2011-11-07 13:55:56


Tema de referenciaTema de referencia | Versión 8.0.0.0 | ak05530_