XPath的index-of()函数怎么查找位置？

XPath的index-of()函数是用于查询指定值在序列中位置的内置函数，属于XPath 2.0及更高版本的核心函数集合，能够返回目标值在输入序列里所有出现位置的索引集合，索引从1开始计数，该函数在处理XML节点序列、字符串序列等场景中有着广泛的使用。

index-of()函数的基本语法

index-of()函数的标准语法格式如下：

index-of($seq as item()*, $search as item()) as xs:integer*
index-of($seq as item()*, $search as item(), $collation as xs:string) as xs:integer*

第一个参数是要查询的序列，可以是节点序列、字符串序列或者其他任意XPath项序列；第二个参数是需要查找的目标值；第三个可选参数是排序规则，用于指定字符串比较时的规则，通常可以省略。函数返回的结果是xs:integer类型的序列，包含目标值在输入序列中所有出现的位置，如果目标值不存在于序列中，返回空序列。

基础使用示例

下面通过一个简单的XPath表达式示例，演示index-of()函数查找位置的基本用法，假设我们有一个字符串序列，需要查找其中某个字符串的位置：

let $str_seq := ("apple", "banana", "apple", "orange", "apple")
return index-of($str_seq, "apple")

这段表达式的执行结果是(1, 3, 5)，因为"apple"在序列中分别出现在第1、3、5个位置，索引从1开始计数。

在XML节点序列中查找位置

index-of()函数最常用的场景是在XML节点序列中查找指定节点的位置，比如我们有一个如下结构的XML文档：

<bookstore>
  <book category="cooking">
    <title lang="en">Everyday Italian</title>
    <author>Giada De Laurentiis</author>
    <year>2005</year>
    <price>30.00</price>
  </book>
  <book category="children">
    <title lang="en">Harry Potter</title>
    <author>J K. Rowling</author>
    <year>2005</year>
    <price>29.99</price>
  </book>
  <book category="web">
    <title lang="en">XQuery Kick Start</title>
    <author>James McGovern</author>
    <year>2003</year>
    <price>49.99</price>
  </book>
  <book category="web">
    <title lang="en">Learning XML</title>
    <author>Erik T. Ray</author>
    <year>2003</year>
    <price>39.95</price>
  </book>
</bookstore>

如果我们想要查找所有category为web的<book>节点在全部<book>节点序列中的位置，可以使用以下XPath表达式：

let $all_books := /bookstore/book
return index-of($all_books, $all_books[@category="web"])

执行这段表达式会返回(3, 4)，说明category为web的<book>节点分别是第3个和第4个<book>节点。

注意事项

• index-of()函数仅支持XPath 2.0及以上版本，XPath 1.0中没有该函数，使用时需要确认运行环境支持的XPath版本。
• 函数的位置索引从1开始，而不是从0开始，这一点和很多编程语言的数组索引规则不同，使用时需要注意。
• 如果查找的目标值在序列中出现多次，函数会返回所有对应的位置，不是只返回第一个位置。
• 当目标值不存在于输入序列中时，函数返回空序列，而不是返回0或者负数，处理返回结果时需要做空序列判断。

结合XSLT的使用示例

在XSLT中，我们也可以使用index-of()函数来处理节点位置，比如下面的XSLT模板，会输出每个<book>节点在其父节点下的位置：

<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
  <xsl:template match="/bookstore">
    <xsl:for-each select="book">
      <p>
        书名：<xsl:value-of select="title"/>，
        位置：<xsl:value-of select="index-of(/bookstore/book, .)"/>
      </p>
    </xsl:for-each>
  </xsl:template>
</xsl:stylesheet>

这段XSLT模板会遍历所有<book>节点，输出每个节点的书名和对应的位置索引，运行后会得到每个<book>在序列中的具体位置。

XPathindex-of()函数XML查询XSLT修改时间：2026-06-16 10:09:14