置換式

置換式によって、既存のノードが新規のゼロ個以上のノードのシーケンスで置換されるか、またはノードの ID は保持してノードの値が置換されます。

構文

構文図を読む
>>-replace--+----------+--node--target-expression--with--source-expression-><
            '-value of-'                                                     

replace
置換式を開始するキーワード。
value of
置換対象の target-expression ノードの値の置換を指定するキーワード。
node
ターゲット式を開始するキーワード。
target-expression
更新式以外の XQuery 式。target-expression の結果は、文書ノードでない単一ノードでなければなりません。target-expression の結果が空シーケンスの場合は、エラーが戻されます。

value of キーワードを指定しない場合、target-expression の結果は、親プロパティーが空でない単一ノードとなる必要があります。

with
ソース式を開始するキーワード。
source-expression
更新式以外の XQuery 式。

value of キーワードを指定した場合、source-expression の結果は単一テキスト・ノードか空シーケンスになります。処理中に、source-expression はアトム化が適用され、アトミック値のシーケンスに変換されます。アトム化の結果が空シーケンスである場合、source-expression の結果は空シーケンスとなります。空シーケンスでない場合、アトム化されたシーケンス内の各アトミック値はストリングにキャストされます。ストリングはすべて連結され、このときストリングの各ペア間にシングル・スペースが挿入されます。

value of キーワードを指定しない場合、source-expression の結果はノードのシーケンスとなる必要があります。source-expression シーケンスに文書ノードが含まれていると、文書ノードはその子で置換されます。 source-expression 式に 1 つ以上のアトミック値の隣接するシーケンスが含まれていると、新しいテキスト・ノードが構成されます。このテキスト・ノードには、各アトミック値をストリングにキャストした結果が入り、隣接する値の間にシングル・スペースが挿入されます。source-expression シーケンスは、以下のノード・タイプで構成されている必要があります。

  • target-expression ノードが属性ノードの場合、置換シーケンスはゼロ個以上の属性ノードで構成されている必要があります。
  • target-expression ノードがエレメント、テキスト、コメント、または処理命令ノードの場合、置換シーケンスはゼロ個以上のエレメント、テキスト、コメント、または処理命令ノードの何らかの組み合わせでなければなりません。
value of キーワードが指定されていると、以下の更新が生成されます。
  • target-expression ノードがエレメント・ノードの場合、target-expression ノードの既存の子は、source-expression によって戻されたテキスト・ノードに置換されます。 source-expression から空シーケンスが戻される場合、target-expression ノードの子プロパティーは空になります。target-expression ノードに属性ノードが含まれている場合、この属性ノードは影響を受けません。
  • target-expression ノードがエレメント・ノードでない場合、target-expression ノードのストリング値は、source-expression によって戻されたテキスト・ノードのストリング値に置換されます。 source-expression からテキスト・ノードが戻されない場合、target-expression ノードのストリング値はゼロ長のストリングに置換されます。

    target-expression ノードがコメント・ノードで、source-expression から戻されたテキスト・ノードのストリング値に 2 つの隣接するハイフンが含まれているかまたはハイフンで終わっている場合は、エラーが戻されます。

    target-expression ノードが処理命令ノードで、source-expression から戻されたテキスト・ノードのストリング値にサブストリング "?>" が含まれている場合は、エラーが戻されます。

value of キーワードが指定されていない場合は、以下の更新が生成されます。
  • source-expression ノードによって target-expression ノードが置換されます。 target-expression ノードの親ノードが各 source-expression ノードの親になります。 source-expression ノードが、target-expression ノードが占めていたノード階層内の位置を占めるようになります。
  • target-expression ノードとそのすべての属性および子孫は、ノード・シーケンスから切り離されます。
  • target-expression に属性ノードが含まれていて、置換シーケンス内の属性ノードに暗黙の名前空間バインドで修飾された名前 (QName) がある場合、target-expression ノードの親ノードの namespaces プロパティーは、まだバインドされていない属性名前空間接頭部のための名前空間バインドを含めるように変更されます。暗黙の名前空間バインディングが、target-expression ノードの親ノードの namespaces プロパティー内の名前空間バインディングと競合する場合は、エラーが戻されます。

ノードが置換された結果、同じ親を持つ隣接テキスト・ノードになると、隣接テキスト・ノードは単一テキスト・ノードにマージされます。結果として得られるテキスト・ノードのストリング値は、隣接するテキスト・ノードのストリング値を連結したものになります。 この場合、各ストリング値の間にスペースは追加されません。

置換の結果が XPath 2. 0 および XQuery 1.0 データ・モデルのいずれかの制約に違反する場合、エラーが戻されます。

例

purchaseOrder 文書が以下のようになっていると仮定します。

<ipo:purchaseOrder
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xmlns:ipo="http://www.example.com/IPO"
   orderDate="2008-12-01">
  <shipTo exportCode="1" xsi:type="ipo:UKAddress">
    <name>Helen Zoe</name>
    <street>55 Eden Street</street>
    <city>San Jose</city>
    <state>CA</state>
    <postcode>CB1 1JR</postcode>
  </shipTo>
  <shipTo exportCode="1" xsi:type="ipo:UKAddress">
    <name>Joe Lee</name>
    <street>66 University Avenue</street>
    <city>Palo Alto</city>
    <state>CA</state>
    <postcode>CB1 1JR</postcode>
  </shipTo>
  <billTo xsi:type="ipo:USAddress">
    <name>Robert Smith</name>
    <street>8 Oak Avenue</street>
    <city>Old Town</city>
    <state>PA</state>
    <zip>95819</zip>
  </billTo>
  <items>
    <item partNum="833-AA">
      <productName>Lapis necklace</productName>
      <quantity>1</quantity>
      <USPrice>99.95</USPrice>
      <ipo:comment>Want this for the holidays!</ipo:comment>
      <shipDate>2008-12-05</shipDate>
    </item>
    <item partNum="945-ZG">
      <productName>Sapphire Bracelet</productName>
      <quantity>2</quantity>
      <USPrice>178.99</USPrice>
      <shipDate>2009-01-03</shipDate>
    </item>
  </items>
</ipo:purchaseOrder>

以下の SQL UPDATE ステートメントは基本更新式を使用して、purchaseOrder 文書の billTo ノード内の street ノードの値を新規の値で置換します。

UPDATE PURCHASEORDER
 SET PORDER = XMLMODIFY(
 'declare namespace ipo="http://www.example.com/IPO";
 replace value of node /ipo:purchaseOrder/billTo/street
 with "505 First Street"')

このステートメントの結果は、以下のようになります。

<ipo:purchaseOrder
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xmlns:ipo="http://www.example.com/IPO"
   orderDate="2008-12-01">
  <shipTo exportCode="1" xsi:type="ipo:UKAddress">
    <name>Helen Zoe</name>
    <street>55 Eden Street</street>
    <city>San Jose</city>
    <state>CA</state>
    <postcode>CB1 1JR</postcode>
  </shipTo>
  <shipTo exportCode="1" xsi:type="ipo:UKAddress">
    <name>Joe Lee</name>
    <street>66 University Avenue</street>
    <city>Palo Alto</city>
    <state>CA</state>
    <postcode>CB1 1JR</postcode>
  </shipTo>
  <billTo xsi:type="ipo:USAddress">
    <name>Robert Smith</name>
    <street>505 First Street</street>
    <city>Old Town</city>
    <state>PA</state>
    <zip>95819</zip>
  </billTo>
  <items>
    <item partNum="833-AA">
      <productName>Lapis necklace</productName>
      <quantity>1</quantity>
      <USPrice>99.95</USPrice>
      <ipo:comment>Want this for the holidays!</ipo:comment>
      <shipDate>2008-12-05</shipDate>
    </item>
    <item partNum="945-ZG">
      <productName>Sapphire Bracelet</productName>
      <quantity>2</quantity>
      <USPrice>178.99</USPrice>
      <shipDate>2009-01-03</shipDate>
    </item>
  </items>
</ipo:purchaseOrder>