キャスト可能式

キャスト可能式は、値を特定のデータ・タイプにキャストできるかどうかテストします。値をデータ・タイプにキャストできる場合、キャスト可能式は true を戻します。それ以外の場合、この式は false を戻します。

キャスト可能式を述部として使用して、評価時のキャスト・エラーを回避できます。また、値の処理に適切なタイプの選択にも使用できます。

構文

構文図を読む
>>-expression--castable as--target-type--+---+-----------------><
                                         '-?-'   

expression
単一アトミック値または空シーケンスを戻す XQuery 式。
target-type
expression の値をキャストできるかどうかのテストに使用されるタイプ。target-type は、事前定義 XML スキーマ・タイプの 1 つであるアトミック・タイプである必要があります。データ・タイプ xs:anyAtomicType および xs:anySimpleType は target-type に対して有効なタイプではありません。
?
空シーケンスがターゲット・タイプの有効なインスタンスとみなされることを示します。expression が空シーケンスと評価され、? が指定されない場合、キャスト可能式は false を戻します。

戻り値

expression を target-type にキャストできる場合、キャスト可能式は true を戻します。それ以外の場合、この式は false を戻します。

expression の結果が空シーケンスで target-type の後に疑問符 (?) 標識がある場合、キャスト可能式は true を戻します。次の例では、ターゲット・タイプ xs:integer の後に疑問符 (?) 標識があります。

$prod/revision castable as xs:integer?
次の場合、エラーが戻されます。
  • expression の結果が、複数のアトミック値からなるシーケンスである。
  • target-type が、in-scope XML スキーマ・タイプに定義されているアトミック・データ・タイプではない、またはキャスト可能式で使用できないデータ・タイプである。

例

以下の例では、キャスト可能式を述部として使用し、評価時のエラーを回避します。この例では、@OrderDate が有効な日付でない場合に動的エラーが回避されます。

let $i := if ( $po/@OrderDate castable as xs:date)
              then xs:date($po/@OrderDate) gt xs:date("2009-01-01")
              else 0
return  $po/orderID[$i]

日付属性が 2009 年 1 月 1 日よりも大きい有効な日付である場合のみ、述語が true になり、orderID が戻されます。 それ以外の場合、述部は false となり空シーケンスが戻されます。

以下の例では、キャスト可能式を使用して、指定した値の処理に適切なタイプを選択します。この例は郵便番号を整数またはストリングとしてキャストします。

if ($postalcode castable as xs:integer)
   then xs:integer($postalcode)
   else xs:string($postalcode)

以下の例では、キャスト可能式を FLWOR let 文節で使用して、$prod/mfgdate の値をテストし、値を $currdate にバインドします。キャスト可能式は、疑問符 (?) 標識を使用して、空シーケンスの処理をサポートします。

let $currdate := if ($prod/mfgdate castable as xs:date?)
   then xs:date($prod/mfgdate)
   else xs:date("2000-01-01")

$prod/mfgdate の値を xs:date としてキャストできる場合、この値はこのデータ・タイプにキャストされ、$currdate にバインドされます。 $prod/mfgdate が空シーケンスの場合、空シーケンスは $currdate にバインドされます。$prod/mfgdate を xs:date としてキャストできない場合、タイプ xs:date の値 2000-01-01 は $currdate にバインドされます。

次の例では、XMLEXISTS 述部内のキャスト可能式は、比較を行う前に /prod/category の値をテストして、評価時のエラーを回避します。XML 列の FEATURES.INFO では、ドキュメントにエレメント /prod/category が含まれています。 値は数字コードまたはストリング・コードです。

SELECT F.PRODID FROM F FEATURES
  WHERE XMLEXISTS('$test/prod/category[ (( . castable as xs:double) and . > 100 ) or
  (( . castable as xs:string) and . > "A100" )]'
  PASSING F.INFO as "test")

戻り値は、カテゴリー・コードが数値 100 よりも大きいかまたはストリング "A100" よりも大きい製品 ID となります。