Скалярная функция XMLTEXT

>>-XMLTEXT--(--строковое-выражение--)----------------------------><

Схема - SYSIBM. Имя функции не может задаваться как квалифицированное имя.

Функция XMLTEXT возвращает XML-значение с единственным текстовым узлом XQuery, имеющим входной аргумент в качестве содержимого.

строковое-выражение

Выражение, значение которого имеет тип символьной строки: CHAR, VARCHAR или CLOB.

Тип данных результата - XML. Если результат строкового-выражения может быть null, результат может быть null; если входное значение - null, результат имеет значение null. Если результат строкового-выражения является пустой строкой, результирующее значение - пустой текстовый узел.

Примечания:

1. Поддержка в базах данных не-Unicode и базах данных с многими разделами: XMLTEXT не поддерживается (SQLSTATE 42997).

Примеры:

• Выполнить простой запрос XMLTEXT.

  VALUES(
       XMLTEXT(
         'The stock symbol for Johnson&Johnson is JNJ.'
       )
  )
  

  Этот запрос вырабатывает следующий сериализованняй результат:

  1
  ---------------------------------------------------
  The stock symbol for Johnson&Johnson is JNJ.
  

  Заметьте, что знак '&' отображается в '&' при сериализации текстового узла.

• Использовать 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, can not generate
  
     SELECT XMLELEMENT(
       NAME "para", XMLAGG(
         XMLCONCAT(
           XMLTEXT(
             PLAINTEXT
           ),
           XMLELEMENT(
             NAME "emphasis", EMPHTEXT
           )
         )
         ORDER BY SEQNO
       ), '.'
     ) AS "результат"
     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, can not generate
  <emphasis>mixed content</emphasis>.</para>