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

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

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

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

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

Выражение, значение которого имеет тип символьной строки: CHAR, VARCHAR или CLOB. Результат строкового-выражения разбирается для проверки соответствия требованиям к комментариию XML, как определено в правилах XML 1.0. Результат строкового-выражения должен соответствовать следующему регулярному выражению:

 
   ((Char - '-') | ('-' (Char - '-')))*

где Char определяется как любой символ Unicode, кроме X'FFFE' или X'FFFF'. В основном, комментарий XML не может содержать два дефиса подряд и не может кончаться дефисом (SQLSTATE 2200S).

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

Примечания:

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