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>'))