fn:distinct-values 関数

fn:distinct-values 関数は、シーケンス内の特殊値を戻します。

構文

構文図を読む
>>-fn:distinct-values(sequence-expression)---------------------><

sequence-expression
アトミック値のシーケンス、または空のシーケンス。シーケンス内の項目は、次の任意のタイプを持つことができます。
  • 数値
  • ストリング
  • 日付または時刻タイプ

戻り値

sequence-expression が空のシーケンスでない場合、戻り値は sequence-expression 内の特殊値である xs:string 値を含むシーケンスです。 2 つの項目は、それらが相互に等しくない場合、区別されます。XQuery は、以下の規則を使用して特殊値のシーケンスを取得します。

  • 2 つの値を比較できない場合、それらの値は異なるとみなされます。
  • タイプ xs:untypedAtomic の値は、xs:string タイプの規則を使用して比較されます。
  • 値のシーケンスが戻される順序は、入力順序と同じでない可能性があります。
  • 等しいと比較された値のセットの最初の値が戻されます。
  • sequence-expression が空のシーケンスである場合、空のシーケンスが戻されます。
  • xs:double 値の場合、正のゼロは負のゼロに等しくなります。
  • sequence-expression が複数の NaN 値を含む場合、単一の NaN 値が戻されます。

例

次の例は、ノード b の特殊値を戻します。

SELECT XMLSERIALIZE(                                      
 XMLQUERY ('declare default element namespace            
 "http://posample.org";                                    
 fn:distinct-values($d/x/b)'  PASSING XMLPARSE(DOCUMENT   
 '<x xmlns="http://posample.org">
 <b>1</b><b>a</b><b>1.0</b><b>A</b><b>1</b></x>')
 AS "d")                                                  
 AS CLOB(1K) EXCLUDING XMLDECLARATION)                     
 FROM SYSIBM.SYSDUMMY1                                   

戻り値は ("1", "a", "1.0", "A") です。