Altova XMLSpy 2024 Professional Edition

Navigation: 附录 > XSLT和XPath/XQuery函数 > Altova扩展函数

XSLT函数

首页 上一页 向上一级 下一页

XSLT扩展函数可以在XSLT上下文中的XPath表达式中使用。它们不用于非XSLT上下文（例如，XQuery上下文）。

 

有关函数命名和语言适用性的注意事项

Altova扩展函数可以在XPath/XQuery表达式中使用。除了XPath、XQuery和XSLT标准函数库中可用的功能外，它们还提供了额外的功能。Altova扩展函数在Altova扩展函数命名空间中，http://www.altova.com/xslt-extensions，并在本部分中用altova:前缀表示，假定它与该命名空间绑定。请注意，这些函数可能在未来的产品版本中不被支持，或者个别函数的行为可能会发生变化。有关每个产品版本中对Altova扩展函数的支持的信息，请参见该版本的文档。

 

XPath函数（用于XSLT中的XPath表达式）：

XP1 XP2 XP3.1

XSLT函数（用于XSLT的XPath表达式）：

XSLT1 XSLT2 XSLT3

XQuery函数（用于XQuery的XQuery表达式）：

XQ1 XQ3.1

 

常规函数

单击以展开/折叠distinct-nodes [altova:]

altova:distinct-nodes(node()*) as node()* XSLT1 XSLT2 XSLT3

将一个包含一个或多个节点的集合作为其输入，并返回一个相同的，但减去了有重复值的节点的集合。要进行对比，请使用XPath/XQuery函数fn:deep-equal。

hmtoggle_plus1示例

•altova:distinct-nodes(country)，返回所有country子节点，并减去了具有重复值的节点。

 

 

单击以展开/折叠evaluate [altova:]

altova:evaluate(XPathExpression as xs:string[, ValueOf\$p1, ... ValueOf\$pN]) XSLT1 XSLT2 XSLT3

取一个XPath表达式，以字符串形式传递，作为其必需的参数。将返回已计算的表达式的输出。例如：altova:evaluate('//Name[1]')将返回文档中第一个Name元素的内容。请注意，//Name[1]表达式通过用单引号括起来作为一个字符串传递。

 

altova:evaluate函数可以选择性地处理额外的参数。这些参数是范围内变量的值，具有以下名称：p1, p2, p3... pN。有关用法的几点说明：(i) 变量的名称必须用以下形式定义：pX，其中X是一个整数；(ii) altova:evaluate 函数的参数（参见上方签名），从第二个参数开始，提供了变量的值，参数序列对应于按数字排列的变量序列：p1到pN：第二个参数将是p1变量的值，第三个参数是p2变量的值，以此类推；(iii) 变量的值的类型必须是item*。

 

hmtoggle_plus0示例

<xsl:variable name="xpath" select="'\$p3, \$p2, \$p1'" />

<xsl:value-of select="altova:evaluate(\$xpath, 10, 20, 'hi')" />

输出"hi 20 10"

 

在上方的代码中，请注意以下几点：

 

•altova:evaluate表达式的第二个参数是分配给\$p1变量的值，第三个参数是分配给\$p2变量的值，以此类推。

•请注意，该函数的第四个参数是一个字符串，因为它被括在引号中。

•xs:variable元素的select特性提供了XPath表达式。由于该表达式的类型必须是xs:string，因此它被括在单引号中。

 

 

hmtoggle_plus0下面的示例将进一步展示如何使用变量

•<xsl:variable name="xpath" select="'\$p1'" />
<xsl:value-of select="altova:evaluate(\$xpath, //Name[1])" />
输出第一个Name元素的值
 

•<xsl:variable name="xpath" select="'\$p1'" />
<xsl:value-of select="altova:evaluate(\$xpath, '//Name[1]')" />
输出"//Name[1]"

 

altova:evaluate()扩展函数在XSLT样式表中的XPath表达式包含一个或多个必须动态计算的部分的情况下很有用。例如，假设一个用户输入了他对排序条件的请求，而该条件存储在UserReq/@sortkey特性中。在样式表中，您就可能有以下表达式：<xsl:sort select="altova:evaluate(../UserReq/@sortkey)" order="ascending"/>。altova:evaluate()函数将读取上下文节点的父节点的UserReq子元素的sortkey特性。假设sortkey 特性的值为Price，然后altova:evaluate()函数将返回Price，它将成为select特性的值：<xsl:sort select="../UserReq/@sortkey" order="ascending"/>。如果该sort指令发生在一个名为Order的元素的上下文中，则Order元素将根据其Price子元素的值进行排序。或者，如果@sortkey的值为Date，那么Order元素将根据其Date子元素的值进行排序。因此，Order的排序条件是在运行时从sortkey特性中选择的。这不可能用以下表达式来实现：<xsl:sort select="../UserReq/@sortkey" order="ascending"/>。在上方示例中，排序条件是sortkey特性本身，而不是Price或Date（或任何其他sortkey的当前内容）。

 

提示：静态上下文包括命名空间、类型和函数，但不包括调用环境中的变量。基URI和默认命名空间是继承而来的。

 

hmtoggle_plus0更多示例

•静态变量：<xsl:value-of select="\$i3, \$i2, \$i1" />
输出三个变量的值
 

•带动态变量的动态XPath表达式：
<xsl:variable name="xpath" select="'\$p3, \$p2, \$p1'" />
<xsl:value-of select="altova:evaluate(\$xpath, 10, 20, 30)" />
输出"30 20 10"
 

•不带动态变量的动态XPath表达式：
<xsl:variable name="xpath" select="'\$p3, \$p2, \$p1'" />
<xsl:value-of select="altova:evaluate(\$xpath)" />
输出错误： 没有为\$p3定义变量。

 

 

单击以展开/折叠encode-for-rtf [altova:]

altova:encode-for-rtf(input as xs:string, preserveallwhitespace as xs:boolean, preservenewlines as xs:boolean) as xs:string XSLT2 XSLT3

将输入字符串转化为RTF。空白和新行将根据为其各自的参数指定的布尔值予以保留。

 

 

[ 回到顶部 ]

 

XBRL函数

Altova XBRL函数仅可以在有XBRL支持的Altova产品版本中使用。

 

单击以展开/折叠xbrl-footnotes [altova:]

altova:xbrl-footnotes(node()) as node()* XSLT2 XSLT3

将一个节点作为其输入参数，并返回由该输入节点引用的XBRL脚注节点集合。

 

 

单击以展开/折叠xbrl-labels [altova:]

altova:xbrl-labels(xs:QName, xs:string) as node()* XSLT2 XSLT3

取两个输入参数：一个节点名称和包含该节点的分类标准文件位置。该函数返回与该输入节点关联的XBRL标签节点。

 

 

 

[ 回到顶部 ]

 

© 2017-2023 Altova GmbH