Função EXISTS

A função EXISTS retorna um valor BOOLEAN indicando se uma lista contém pelo menos um elemento (ou seja, se a lista existe).

SINTAXE

Se a lista especificada por ListExpression contiver um ou mais elementos, EXISTS retornará TRUE. Se a lista não contiver elementos, EXISTS retornará FALSE.

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)

Se você deseja apenas saber se uma lista contém algum elemento ou nenhum o EXISTS será executado mais rápido do que uma expressão que envolve a função CARDINALITY (por exemplo, CARDINALITY(ListExpression ) <> 0).

Um uso comum dessa função é determinar se um campo existe.

Exemplos

-- Determinar se a matriz F1 existe na mensagem. Observe que os [ ]
-- são requeridos
DECLARE Field1Exists BOOLEAN EXISTS(OutputRoot.XML.Data.Source.F1[]);
-- Determinar se a matriz F1 contém um elemento com o valor 'F12'.
-- Novamente, observe que os [ ] são requeridos
DECLARE Field1F12Exists BOOLEAN
  EXISTS(SELECT F.* FROM OutputRoot.XML.Data.Source.F1[] AS F where F = 'F12');
Conceitos relacionados
Visão Geral do ESQL
Tarefas relacionadas
Desenvolvendo ESQL
Referências relacionadas
Função CARDINALITY
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
ak05535_