XMLPI

在线编辑

XMLPI 函数返回具有单个处理指令的 XML 值。

读取语法图跳过可视语法图XMLPI (NAMEpi-名称,string-表达式)
名称 pi-name
指定处理指令的名称。 该名称是必须采用 XML NCName 格式的 SQL 标识。 请参阅 W3C XML 名称空间规范以了解有关有效名称的更多详细信息。 在任何大小写组合中，名称不得为 "xml"。
字符串表达式
返回值为内置字符或图形字符串的表达式。 它不能是 CHAR 或 VARCHAR 位数据。 生成的字符串必须符合以下规则所指定的 XML 处理指令的内容:
  • 该字符串不得包含子串 "?>" ，因为此子串将终止处理指令
  • 字符串的每个字符可以是任何 Unicode 字符，不包括代理块， X'FFFE '和 X'FFFF'。1
如果 string-expression 不符合先前的规则，那么将返回错误。
生成的字符串将成为处理指令的内容。

此函数的结果为 XML。 如果 string-expression 的结果可以为空，那么结果可以为空; 如果 string-expression 的结果为空，那么结果为空值。 如果 string-expression 是空字符串或未指定，那么结果是空的处理指令。

示例

  • 生成 XML 处理指令。
      SELECT XMLPI(
       NAME "Instruction", 'Push the red button')
    FROM SYSIBM.SYSDUMMY1

    此查询将生成以下结果：

    <?Instruction Push the red button?>
  • 生成空的 XML 处理指令。
      SELECT XMLPI(NAME "Warning")
    FROM SYSIBM.SYSDUMMY1

    此查询将生成以下结果：

    <?Warning ?>
1有效的 Unicode 字符由以下 Unicode 代码点组成：#x9、#xA, #xD, #x20-#xD7FF、#xE000-#xFFFD、#x10000-#x10FFFF。