CARDINALITY 関数

CARDINALITY 関数は、リスト内のエレメントの数を戻します。

構文

構文図を読む構文図をスキップする
>>-CARDINALITY--(--ListExpression--)---------------------------><

CARDINALITY は、ListExpression で指定された、リスト内のエレメントの数を示す整数値を戻します。

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

この関数の一般的な使用法としては、リスト内のフィールドを繰り返す前に、それらのフィールドの数を判別する場合があります。

例

-- Determine the number of F1 fields in the message.
-- Note that the [ ] are required   
DECLARE CountF1 INT CARDINALITY(OutputRoot.XMLNS.Data.Source.F1[]);
-- Determine the number of fields called F1 with the value 'F12' in the message.
-- Again note that the [ ] are required
DECLARE CountF1F12 INT     
  CARDINALITY(SELECT F.* FROM OutputRoot.XMLNS.Data.Source.F1[] AS F 
              where F = 'F12');
-- Use the value returned by CARDINALITY to refer to a specific element 
-- in a list or array:
-- Array indices start at 1, so this example refers to the third-from-last
-- instance of the Item field
Body.Invoice.Item[CARDINALITY(Body.Invoice.Item[]) - 2].Quantity
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        最終更新
        
        最終更新 : 2013-02-27 19:20:51


参照トピック参照トピック | バージョン 8.0.0.2 | ak05530_