9.14. XML函数

9.14.1.1. xmlcomment

xmlcomment(text)

xmlcomment函数创建一个包含XML注释的特定文本内容的值。文本中不能包含"--" 或"-"的结束，这样的文本是有效的XML注释。如果参数是空，结果是空。

Example:

SELECT xmlcomment('hello');

  xmlcomment
--------------
<!--hello-->

9.14.1.2. xmlconcat

xmlconcat(xml[， ...])

函数xmlconcat连接一个独立的XML值列表来创建一个包含XML内容片段的单值。 忽略空值；只有当参数都为空时结果是空。

示例：

SELECT xmlconcat('<abc/>'， '<bar>foo</bar>');

      xmlconcat
----------------------
<abc/><bar>foo</bar>

XML声明，如果存在，结合如下。如果所有参数使用相同的XML版本声明，则在结果是使用版本。否则不用版本。 如果所有的参数值有独立的声明值，然后这个值在结果里使用。如果所有的参数值有独立的声明，并且至少有一个是"没有的"， 然后这个值在结果里使用。否则结果将没有独立声明。如果结果决定需要一个独立的声明，但没有声明版本，将使用一个带有版本1.0的版本声明， 因为XML需要一个XML声明包含版本声明。忽略编码声明，在所有情况下删除。

Example:

SELECT xmlconcat('<?xml version="1.1"?><foo/>'， '<?xml version="1.1" standalone="no"?><bar/>');

             xmlconcat
-----------------------------------
<?xml version="1.1"?><foo/><bar/>

9.14.1.3. xmlelement

xmlelement(namename[， xmlattributes(value[ASattname][， ...])][， content， ...])

xmlelement表达式生成 一个带有给定名称，属性和内容的XML元素。

示例：

SELECT xmlelement(name foo);

 xmlelement
------------
<foo/>

SELECT xmlelement(name foo， xmlattributes('xyz' as bar));

    xmlelement
------------------
<foo bar="xyz"/>

SELECT xmlelement(name foo， xmlattributes(current_date as bar)， 'cont'， 'ent');

             xmlelement
-------------------------------------
<foo bar="2007-01-26">content</foo>

不合法的元素和属性名由逃逸序列_xHHHH_替换有问题的字符， 这里的HHHH是字符Unicode编码值的16进制表示。例如：

SELECT xmlelement(name "foo$bar"， xmlattributes('xyz' as "a&b"));

            xmlelement
----------------------------------
<foo_x0024_bar a_x0026_b="xyz"/>

需要一个明确的属性名称，如果属性值是一个列引用则不用指定， 在这种情况下，列的名称将默认为属性名。 在其它情况下，属性必须给予一个明确的名称。 因此，这个例子是有效：

CREATE TABLE test (a xml， b xml);
SELECT xmlelement(name test， xmlattributes(a， b)) FROM test;

但是这些不是:

SELECT xmlelement(name test， xmlattributes('constant')， a， b) FROM test;
SELECT xmlelement(name test， xmlattributes(func(a， b))) FROM test;

元素内容，如果指定，将格式化相应的数据类型。如果内容自身是xml类型， 可以构造复杂的xml文档。例如：

SELECT xmlelement(name foo， xmlattributes('xyz' as bar)，
                            xmlelement(name abc)，
                            xmlcomment('test')，
                            xmlelement(name xyz));

                  xmlelement
----------------------------------------------
<foo bar="xyz"><abc/><!--test--><xyz/></foo>

将其它类型的内容格式化为有效的xml字符串数据。这意味着特殊字符 <， >， and &将转化为一般符号。将二进制数据（bytea数据类型用base64或16进值编码表示，根据 配置参数xmlbinary的设置。单个数据类型的特定行为，预计演变以对齐与 XML 架构规范， 在哪个点的更准确描述将出现 SQL 和 PostgreSQL 的数据类型。

9.14.1.4. xmlforest

xmlforest(content[ASname][， ...])

xmlforest表达式生成一个 XML 森林使用指定的名称和内容元素的序列。

示例:

SELECT xmlforest('abc' AS foo， 123 AS bar);

          xmlforest
------------------------------
<foo>abc</foo><bar>123</bar>


SELECT xmlforest(table_name， column_name)
FROM information_schema.columns
WHERE table_schema = 'pg_catalog';

                                         xmlforest
-------------------------------------------------------------------------------------------
<table_name>pg_authid</table_name><column_name>rolname</column_name>
<table_name>pg_authid</table_name><column_name>rolsuper</column_name>
 ...

在第二个例子可以看出，如果内容值为列引用，元素名称可以省略。在这种情况下，默认使用列名。否则，必须指定名称。

非法XML名的元素名称，像上面的xmlelement逃逸处理。类似内容数据逃逸生成有效的XML内容， 除非它已经是xml类型的。

请注意，如果组成一个以上的元素，XML的森林不是有效的XML文档，所以在xmlelement封装 xmlforest表达式可能是有用的。

9.14.1.5. xmlpi

xmlpi(nametarget[，content])

xmlpi表达式创建一条XML处理指令。 如果存在，内容必须不能包含字符序列?>。

示例:

SELECT xmlpi(name php， 'echo "hello world";');

            xmlpi
-----------------------------
<?php echo "hello world";?>

9.14.1.6. xmlroot

xmlroot(xml， versiontext| no value[， standalone yes|no|no value])

xmlroot表示更改根节点属性的XML值。如果指定一个版本， 它替换根节点的版本声明值;如果指定一个standalone设置，它替换根节点的standalone声明。

SELECT xmlroot(xmlparse(document '<?xml version="1.1"?><content>abc</content>')， 
               version '1.0'， standalone yes);

                xmlroot
----------------------------------------
<?xml version="1.0" standalone="yes"?>
<content>abc</content>

9.14.1.7. xmlagg

xmlagg(xml)

函数xmlagg，不像其它这里描述的函数，聚合函数。它连接聚合函数调用的输入值， 很像xmlconcat，除了串联发生跨行，而不是单行中跨表达式。请参阅Section 9.18 获取关于聚合函数的更多信息。

示例：

CREATE TABLE test (y int， x xml);
INSERT INTO test VALUES (1， '<foo>abc</foo>');
INSERT INTO test VALUES (2， '<bar/>');
SELECT xmlagg(x) FROM test;
        xmlagg
----------------------
<foo>abc</foo><bar/>

为了确定连接顺序，一个ORDER BY子句要添加到聚合调用，描述在Section 4.2.7。 示例：

SELECT xmlagg(x ORDER BY y DESC) FROM test;
        xmlagg
----------------------
<bar/><foo>abc</foo>

建议在之前的版本中使用下面非标准的方法，在特例中可能仍然有用:

SELECT xmlagg(x) FROM (SELECT * FROM test ORDER BY y DESC) AS tab;
        xmlagg
----------------------
<bar/><foo>abc</foo>

9.14.1.8. XML谓词

xmlIS DOCUMENT

表达式IS DOCUMENT如果参数XML值是一个合法的XML文档，返回真。否则返回假（例如，内容片段）或如果参数为空则返回空。 请参阅Section 8.13关于文档和内容片段之间的不同。