fn:boolean 関数

fn:boolean 関数は、シーケンスの有効なブール値を戻します。

構文

>>-fn:boolean(sequence-expression)-----------------------------><

sequence-expression
任意のタイプの項目を含むシーケンス、または空のシーケンス。

戻り値

戻り値は xs:boolean 値であり、sequence-expression の値によって異なります。
  • sequence-expression が空のシーケンスの場合は、false が戻されます。
  • sequence-expression が空のシーケンスでなく、sequence-expression に値が 1 つ含まれている場合は、次のようになります。
    • 値が xs:boolean 値 false である場合は、false が戻されます。
    • 値がゼロ長ストリングで、タイプが xs:string または xs:untypedAtomic である場合は、false が戻されます。
    • 値が 0 で、タイプが数値タイプの場合は、false が戻されます。
    • 値が NaN で、タイプが xs:double の場合は、false が戻されます。
    • それ以外の場合は、true が戻されます。
  • sequence-expression が空のシーケンスでなく、sequence-expression に複数の値が含まれている場合は、true が戻されます。

例

以下の関数は、 両方ともゼロより大きい長さのストリングであるため、true を戻します。
  • fn:boolean("true")
  • fn:boolean("false")

次の関数は、sequence-expression の値が 0 で、タイプが numeric であるため、false を戻します: fn:boolean(0)

以下の例は、 より大きい Db2® のコンテキスト で、fn:boolean 関数がどのように使用されるかを示しています。 XMLQUERY ステートメントを使用して XML データを照会し、最初の引数として XQuery 式をとっています。両方のケースで、fn:boolean 関数は PASSING 文節から渡されるデータです。 最初の例で、fn:boolean 関数の引数は 3 つのゼロ・シーケンスになります。2 番目の例で、 fn:boolean 関数の引数は、3 つの「false」値になります。sequence-expression に複数の値が含まれて いるため、両方の関数は true と評価します。
XMLQUERY('fn:boolean($x)' PASSING XMLCONCAT(XMLQUERY('0'),
 XMLQUERY('0'),XMLQUERY('0')))
XMLQUERY('fn:boolean(fn:data(//b))' 
 PASSING XMLPARSE(DOCUMENT '<a><b>false</b><b>false></b><b>false</b></a>'))