XMLTEXT スカラー関数

XMLTEXT 関数は、入力引数を内容として持つ、単一の XQuery テキスト・ノードがある XML 値を戻します。

Read syntax diagramSkip visual syntax diagramXMLTEXT(string-expression )

スキーマは SYSIBM です。 関数名を修飾名で指定することはできません。

ストリング式
値が文字ストリング・タイプ CHAR、VARCHAR、または CLOB を持つ式。

結果のデータ・タイプは XML です。 string-expression の結果が NULL になる可能性がある場合、結果も NULL になる可能性があります。入力値が NULL であれば、結果も NULL 値になります。 string-expression の結果が空ストリングであれば、結果の値は空テキスト・ノードです。

  • 例 1: 単純な XMLTEXT 照会を作成します。
       VALUES(
         XMLTEXT(
           'The stock symbol for Johnson&Johnson is JNJ.'
         )
       )
    この照会は、以下のシリアライズされた結果を生成します。
    1
    ---------------------------------------------------
    The stock symbol for Johnson&Johnson is JNJ.
    「&」記号は、テキスト・ノードがシリアライズされるときには「&」にマップされることに注意してください。
  • 例 2: XMLTEXT を XMLAGG と共に使用して、混合の内容を構成します。 表 T の内容が以下のようであるとします。
    seqno  plaintext
                                                      emphtext
    ------ -----------------------------------------------------------
    -------------
    1      This query shows how to construct                         
     mixed content
    2       using XMLAGG and XMLTEXT. Without                        
     XMLTEXT
    3      XMLAGG will not have text nodes to group with other nodes,
     mixed content
           therefore, cannot generate
       SELECT
    XMLELEMENT(
         NAME "para", XMLAGG(
           XMLCONCAT(
             XMLTEXT(
               PLAINTEXT
             ),
             XMLELEMENT(
               NAME "emphasis", EMPHTEXT
             )
           )
           ORDER BY SEQNO
         ), '.'
       ) AS "result"
       FROM T
    この照会は、次のような結果を生成します。
    result
    -------------------------------------------------------------------------------
    <para>This query shows how to construct <emphasis>mixed content</emphasis>
    using XMLAGG and XMLTEXT. Without <emphasis>XMLTEXT</emphasis>
    , XMLAGG
    will not have text nodes to group with other nodes, therefore, cannot
    generate
    <emphasis>mixed content</emphasis>.</para>