SINGULAR 函数

SINGULAR 函数返回一个 BOOLEAN 值,表明列表是否只包含一个元素。

语法

如果 ListExpression 指定的列表只包含一个元素,SINGULAR 返回 TRUE。如果该列表包含更多或更少元素,SINGULAR 返回 FALSE。

ListExpression 是返回列表的任何表达式。例如,下列各项全部返回列表:
  • LIST 构造函数
  • 带数组指示符 [] 的字段引用
  • 某些 SELECT 表达式(并非全部返回列表)

如果只想知道列表是只包含一个元素还是包含某些其他元素,则 SINGULAR 比使用 CARDINALITY 函数(例如,CARDINALITY(ListExpression) = 1)的表达式执行速度更快。

此函数通常用于确定字段是否唯一。

示例

-- Determine whether there is just one F1 field in the message.
-- Note that the [ ] are required
DECLARE Field1Unique BOOLEAN SINGULAR(OutputRoot.XML.Data.Source.F1[]);
-- Determine whether there is just one field called F1 with the value 'F12'
-- in the message. Again note that the [ ] are required
DECLARE Field1F12Unique BOOLEAN
  SINGULAR(SELECT F.* FROM OutputRoot.XML.Data.Source.F1[] AS F where F = 'F12');
相关概念
ESQL 概述
相关任务
正在开发 ESQL
相关参考
CARDINALITY 函数
EXISTS 函数
THE 函数
语法图:可用类型
ESQL 列表函数
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
ak05585_