SINGULAR 関数

SINGULAR 関数は、リストに厳密に 1 つのエレメントが含まれているかどうかを示すブール値を戻します。

構文

ListExpression で指定されたリストに厳密に 1 つのエレメントが含まれている場合、SINGULAR は TRUE を戻します。リストに複数のエレメントが含まれているか、エレメントが含まれていない場合は、SINGULAR は FALSE を戻します。

ListExpression はリストを戻す式です。例えば、以下のものはすべてリストを戻します。
  • LIST コンストラクター
  • [] 配列標識を使用したフィールド参照
  • 一部の SELECT 式 (リストを戻さないものもある)

リストに含まれているエレメントが 1 つのみかそれ以外かのみ知りたい場合は、CARDINALITY 関数に関する式 (CARDINALITY(ListExpression ) = 1 など) よりも、SINGULAR の方が速く実行できます。

この関数の一般的な使用法としては、フィールドが固有かどうかを判別する場合があります。

-- 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 最終更新: 08/21/2006
ak05585_