FUNCTIONXML 函数
xmltext
函数 xmltext 返回一个只包含单个文本节点的 XML 值，该文本节点的内容就是输入参数。
The function xmltext returns an XML value with a single text node containing the input argument as its content.
XML 函数 引入 17 现存至 20 devel 1 条签名 0 次签名变更
- 分组
- XML 函数
- 签名数
- 1 条
- 引入版本
- 17
- 状态
- 现存
- 签名变更
- 未变过
- 本版来源
- 本站译文
版本轨迹
相对 PostgreSQL 17 无变化。
签名
PostgreSQL 18 里 xmltext 的 1 条签名，按上游手册顺序排列。参数名用斜体，类型用弱化色， 之后是返回类型。说明取自本站手册译文：标「沿用」的借用了另一版的译文，标「EN」的本站暂无译文、按英文原文显示。
-
xmltext(text) →xml函数xmltext返回一个只包含单个文本节点的 XML 值，该文本节点的内容就是输入参数。预定义实体，例如和号（&）、左右尖括号（< >）以及引号（""），都会被转义。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的签名。
-
PostgreSQL 17 ← 16 新增此函数
PostgreSQL 17 起可用
签名矩阵
每条签名在给出了签名的 4 个版本里的存在情况；方格指向该版的签名。只在正文里提到此函数、没有给出签名的版本不列进来，上面的版本轨迹里仍然有它们。签名文本在 PostgreSQL 13 前后写法不同，跨越那一跳的同一条签名会显示成两行。
存在 不存在
同组函数
| 函数 | 签名 | 主签名 | 版本变动 | 最近变更 |
|---|---|---|---|---|
cursor_to_xml基线 |
1 | cursor_to_xml ( cursor refcursor, count integer, nulls boolean, tableforest boolean, targetns text ) → xml |
— | |
| table_to_xml映射由参数table传递的命名表的内容。 | 现存 | |||
cursor_to_xmlschema基线 |
1 | cursor_to_xmlschema ( cursor refcursor, nulls boolean, tableforest boolean, targetns text ) → xml |
— | |
| 最重要的是相同的参数被传递来获得匹配的 XML 数据映射和 XML 模式文档。 | 现存 | |||
database_to_xml基线 |
1 | database_to_xml ( nulls boolean, tableforest boolean, targetns text ) → xml |
— | |
| 这些函数会忽略当前用户不可读的表。 | 现存 | |||
database_to_xml_and_xmlschema基线 |
1 | database_to_xml_and_xmlschema ( nulls boolean, tableforest boolean, targetns text ) → xml |
— | |
| 这些函数会忽略当前用户不可读的表。 | 现存 | |||
database_to_xmlschema基线 |
1 | database_to_xmlschema ( nulls boolean, tableforest boolean, targetns text ) → xml |
— | |
| 这些函数会忽略当前用户不可读的表。 | 现存 | |||
query_to_xml基线 |
1 | query_to_xml ( query text, nulls boolean, tableforest boolean, targetns text ) → xml |
— | |
| table_to_xml映射由参数table传递的命名表的内容。 | 现存 | |||
query_to_xml_and_xmlschema基线 |
1 | query_to_xml_and_xmlschema ( query text, nulls boolean, tableforest boolean, targetns text ) → xml |
— | |
| 下面的函数产生 XML 数据映射和对应的 XML 模式，并把产生的结果链接在一起放在一个文档（或森林）中。 | 现存 | |||
query_to_xmlschema基线 |
1 | query_to_xmlschema ( query text, nulls boolean, tableforest boolean, targetns text ) → xml |
— | |
| 最重要的是相同的参数被传递来获得匹配的 XML 数据映射和 XML 模式文档。 | 现存 | |||
schema_to_xml基线 |
1 | schema_to_xml ( schema name, nulls boolean, tableforest boolean, targetns text ) → xml |
— | |
| 这些函数会忽略当前用户不可读的表。 | 现存 | |||
schema_to_xml_and_xmlschema基线 |
1 | schema_to_xml_and_xmlschema ( schema name, nulls boolean, tableforest boolean, targetns text ) → xml |
— | |
| 这些函数会忽略当前用户不可读的表。 | 现存 | |||
schema_to_xmlschema基线 |
1 | schema_to_xmlschema ( schema name, nulls boolean, tableforest boolean, targetns text ) → xml |
— | |
| 这些函数会忽略当前用户不可读的表。 | 现存 | |||
table_to_xml基线 |
1 | table_to_xml ( table regclass, nulls boolean, tableforest boolean, targetns text ) → xml |
— | |
| table_to_xml映射由参数table传递的命名表的内容。 | 现存 | |||
table_to_xml_and_xmlschema基线 |
1 | table_to_xml_and_xmlschema ( table regclass, nulls boolean, tableforest boolean, targetns text ) → xml |
— | |
| 下面的函数产生 XML 数据映射和对应的 XML 模式，并把产生的结果链接在一起放在一个文档（或森林）中。 | 现存 | |||
table_to_xmlschema基线 |
1 | table_to_xmlschema ( table regclass, nulls boolean, tableforest boolean, targetns text ) → xml |
— | |
| 最重要的是相同的参数被传递来获得匹配的 XML 数据映射和 XML 模式文档。 | 现存 | |||
xml_is_well_formed |
1 | xml_is_well_formed ( text ) → boolean |
— | |
| 这些函数检查一个text串是不是一个良构的 XML，返回一个布尔结果。 | 现存 | |||
xml_is_well_formed_content |
1 | xml_is_well_formed_content ( text ) → boolean |
— | |
| 这些函数检查一个text串是不是一个良构的 XML，返回一个布尔结果。 | 现存 | |||
xml_is_well_formed_document |
1 | xml_is_well_formed_document ( text ) → boolean |
— | |
| 这些函数检查一个text串是不是一个良构的 XML，返回一个布尔结果。 | 现存 | |||
xmlagg基线 |
2 | xmlagg ( xml ) → xml |
171 次 | |
| 和这里描述的其他函数不同，函数xmlagg是一个聚合函数。 | 现存 | |||
xmlcomment基线 |
1 | xmlcomment ( text ) → xml |
— | |
| 函数xmlcomment创建了一个 XML 值，它包含一个使用指定文本作为内容的 XML 注释。 | 现存 | |||
xmlconcat基线 |
1 | xmlconcat ( xml [, ...] ) → xml |
— | |
| 函数xmlconcat将由单个 XML 值组成的列表串接成一个单独的值，这个值包含一个 XML 内容片断。 | 现存 | |||
xmlelement基线 |
1 | xmlelement ( NAME name [, XMLATTRIBUTES ( attvalue [AS attname] [, ...] ) ] [, content [, ...]] ) → xml |
— | |
| 表达式xmlelement使用给定名称、属性和内容产生一个 XML 元素。 | 现存 | |||
XMLEXISTS |
1 | XMLEXISTS ( text PASSING [BY {REF|VALUE}] xml [BY {REF|VALUE}] ) → boolean |
121 次 | |
| 函数xmlexists评价一个XPath 1.0表达式(第一个参数)，以传递的XML值作为其上下文项。 | 现存 | |||
xmlforest基线 |
1 | xmlforest ( content [AS name] [, ...] ) → xml |
— | |
| 表达式xmlforest使用给定名称和内容产生一个元素的 XML 森林（序列）。 | 现存 | |||
xmlpi基线 |
1 | xmlpi ( NAME name [, content] ) → xml |
— | |
| 表达式xmlpi创建一个 XML 处理指令。 | 现存 | |||
xmlroot基线 |
1 | xmlroot ( xml, VERSION {text|NO VALUE} [, STANDALONE {YES|NO|NO VALUE} ] ) → xml |
— | |
| 表达式xmlroot修改一个 XML 值的根结点的属性。 | 现存 | |||
XMLTABLE |
1 | XMLTABLE ( [XMLNAMESPACES ( namespace_uri AS namespace_name [, ...] ), ] row_expression PASSING [BY {REF|VALUE}] document_expression [BY {REF|VALUE}] COLUMNS name { type [PATH column_expression] [DEFAULT default_expression] [NOT NULL | NULL] | FOR ORDINALITY } [, ...] ) → setof record |
121 次 | |
| xmltable表达式基于给定的XML值产生一个表、一个抽取行的XPath过滤器以及一个列定义集合。 | 现存 | |||
xmltext |
1 | xmltext ( text ) → xml |
— | |
| 函数 xmltext 返回一个只包含单个文本节点的 XML 值，该文本节点的内容就是输入参数。 | 现存 | |||
xpath基线 |
1 | xpath ( xpath text, xml xml [, nsarray text[]] ) → xml[] |
9.11 次 | |
| 函数xpath根据 XML 值xml计算 XPath 1.0 表达式xpath (以文本形式给出)。 | 现存 | |||
xpath_exists |
1 | xpath_exists ( xpath text, xml xml [, nsarray text[]] ) → boolean |
— | |
| 函数xpath_exists是xpath函数的一种特殊形式。 | 现存 | |||