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 SINGULAR

A função SINGULAR retorna um valor Booleano que indica se uma lista contém exatamente um elemento.

Sintaxe

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

Se a lista especificada por ListExpression contiver exatamente um elemento, SINGULAR retornará TRUE. Se a lista contiver mais ou menos elementos, SINGULAR retornará FALSE.

ListExpression é uma expressão que retorna uma lista. Todas as expressões a seguir, por exemplo, 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)

Se desejar saber apenas se uma lista contém apenas um elemento ou algum outro número, SINGULAR é executado mais rapidamente que uma expressão envolvendo a função CARDINALITY (por exemplo, CARDINALITY(ListExpression ) = 1).

Um uso típico desta função é para determinar se um campo é exclusivo.

Exemplos

-- Determinar se existe apenas um campo F1 na mensagem.
-- Observe que os [ ] são requeridos
DECLARE Field1Unique BOOLEAN SINGULAR(OutputRoot.XMLNS.Data.Source.F1[]);
-- Determinar se existe apenas um campo chamado F1 com o valor 'F12'
-- na mensagem. Novamente, observe que os [ ] são requeridos
DECLARE Field1F12Unique BOOLEAN
  SINGULAR(SELECT F.* FROM OutputRoot.XMLNS.Data.Source.F1[] AS F where F = 'F12'); 
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 | ak05585_