XPath常用函数

痛定思痛。 2022-01-28 21:01 187阅读 0赞

**目录**

有关数值的函数

有关字符串的函数

关于布尔值的函数

有关序列的函数

一般性的函数

测试序列容量的函数

Equals, Union, Intersection and Except

合计函数

生成序列的函数

上下文函数

函数示例

--------------------

摘自W3School官方文档：[http://www.w3school.com.cn/xpath/index.asp][http_www.w3school.com.cn_xpath_index.asp]

# 有关数值的函数 #

<table> 
 <tbody> 
 <tr> 
 <td> 名称 </td> 
 <td> 说明 </td> 
 </tr> 
 <tr> 
 <td> fn:number(arg) </td> 
 <td> 返回参数的数值。参数可以是布尔值、字符串或节点集。 例子：number('100') 结果：100 </td> 
 </tr> 
 <tr> 
 <td> fn:abs(num) </td> 
 <td> 返回参数的绝对值。 例子：abs(3.14) 结果：3.14 例子：abs(-3.14) 结果：3.14 </td> 
 </tr> 
 <tr> 
 <td> fn:ceiling(num) </td> 
 <td> 返回大于 num 参数的最小整数。 例子：ceiling(3.14) 结果：4 </td> 
 </tr> 
 <tr> 
 <td> fn:floor(num) </td> 
 <td> 返回不大于 num 参数的最大整数。 例子：floor(3.14) 结果：3 </td> 
 </tr> 
 <tr> 
 <td> fn:round(num) </td> 
 <td> 把 num 参数舍入为最接近的整数。 例子：round(3.14) 结果：3 </td> 
 </tr> 
 <tr> 
 <td> fn:round-half-to-even() </td> 
 <td> 例子：round-half-to-even(0.5) 结果：0 例子：round-half-to-even(1.5) 结果：2 例子：round-half-to-even(2.5) 结果：2 </td> 
 </tr> 
 </tbody> 
</table>

# 有关字符串的函数 #

<table> 
 <tbody> 
 <tr> 
 <td> 名称 </td> 
 <td> 说明 </td> 
 </tr> 
 <tr> 
 <td> fn:string(arg) </td> 
 <td> 返回参数的字符串值。参数可以是数字、逻辑值或节点集。 例子：string(314) 结果："314" </td> 
 </tr> 
 <tr> 
 <td> fn:codepoints-to-string(int,int,...) </td> 
 <td> 根据代码点序列返回字符串。 例子：codepoints-to-string(84, 104, 233, 114, 232, 115, 101) 结果：'Thérèse' </td> 
 </tr> 
 <tr> 
 <td> fn:string-to-codepoints(string) </td> 
 <td> 根据字符串返回代码点序列。 例子：string-to-codepoints("Thérèse") 结果：84, 104, 233, 114, 232, 115, 101 </td> 
 </tr> 
 <tr> 
 <td> fn:codepoint-equal(comp1,comp2) </td> 
 <td> 根据 Unicode 代码点对照，如果 comp1 的值等于 comp2 的值，则返回 true。(http://www.w3.org/2005/02/xpath-functions/collation/codepoint)，否则返回 false。 </td> 
 </tr> 
 <tr> 
 <td> fn:compare(comp1,comp2) fn:compare(comp1,comp2,collation) </td> 
 <td> 如果 comp1 小于 comp2，则返回 -1。如果 comp1 等于 comp2，则返回 0。如果 comp1 大于 comp2，则返回 1。（根据所用的对照规则）。 例子：compare('ghi', 'ghi') 结果：0 </td> 
 </tr> 
 <tr> 
 <td> fn:concat(string,string,...) </td> 
 <td> 返回字符串的拼接。 例子：concat('XPath ','is ','FUN!') 结果：'XPath is FUN!' </td> 
 </tr> 
 <tr> 
 <td> fn:string-join((string,string,...),sep) </td> 
 <td> 使用 sep 参数作为分隔符，来返回 string 参数拼接后的字符串。 例子：string-join(('We', 'are', 'having', 'fun!'), ' ') 结果：' We are having fun! ' 例子：string-join(('We', 'are', 'having', 'fun!')) 结果：'Wearehavingfun!' 例子：string-join((), 'sep') 结果：'' </td> 
 </tr> 
 <tr> 
 <td> fn:substring(string,start,len) fn:substring(string,start) </td> 
 <td> 返回从 start 位置开始的指定长度的子字符串。第一个字符的下标是 1。如果省略 len 参数，则返回从位置 start 到字符串末尾的子字符串。 例子：substring('Beatles',1,4) 结果：'Beat' 例子：substring('Beatles',2) 结果：'eatles' </td> 
 </tr> 
 <tr> 
 <td> fn:string-length(string) fn:string-length() </td> 
 <td> 返回指定字符串的长度。如果没有 string 参数，则返回当前节点的字符串值的长度。 例子：string-length('Beatles') 结果：7 </td> 
 </tr> 
 <tr> 
 <td> fn:normalize-space(string) fn:normalize-space() </td> 
 <td> 删除指定字符串的开头和结尾的空白，并把内部的所有空白序列替换为一个，然后返回结果。如果没有 string 参数，则处理当前节点。 例子：normalize-space(' The&nbsp;&nbsp;&nbsp;XML ') 结果：'The XML' </td> 
 </tr> 
 <tr> 
 <td> fn:normalize-unicode() </td> 
 <td> 执行 Unicode 规格化。 </td> 
 </tr> 
 <tr> 
 <td> fn:upper-case(string) </td> 
 <td> 把 string 参数转换为大写。 例子：upper-case('The XML') 结果：'THE XML' </td> 
 </tr> 
 <tr> 
 <td> fn:lower-case(string) </td> 
 <td> 把 string 参数转换为小写。 例子：lower-case('The XML') 结果：'the xml' </td> 
 </tr> 
 <tr> 
 <td> fn:translate(string1,string2,string3) </td> 
 <td> 把 string1 中的 string2 替换为 string3。 例子：translate('12:30','30','45') 结果：'12:45' 例子：translate('12:30','03','54') 结果：'12:45' 例子：translate('12:30','0123','abcd') 结果：'bc:da' </td> 
 </tr> 
 <tr> 
 <td> fn:escape-uri(stringURI,esc-res) </td> 
 <td> 例子：escape-uri("http://example.com/test#car", true()) 结果："http%3A%2F%2Fexample.com%2Ftest#car" 例子：escape-uri("http://example.com/test#car", false()) 结果："http://example.com/test#car" 例子：escape-uri ("http://example.com/~bébé", false()) 结果："http://example.com/~b%C3%A9b%C3%A9" </td> 
 </tr> 
 <tr> 
 <td> fn:contains(string1,string2) </td> 
 <td> 如果 string1 包含 string2，则返回 true，否则返回 false。 例子：contains('XML','XM') 结果：true </td> 
 </tr> 
 <tr> 
 <td> fn:starts-with(string1,string2) </td> 
 <td> 如果 string1 以 string2 开始，则返回 true，否则返回 false。 例子：starts-with('XML','X') 结果：true </td> 
 </tr> 
 <tr> 
 <td> fn:ends-with(string1,string2) </td> 
 <td> 如果 string1 以 string2 结尾，则返回 true，否则返回 false。 例子：ends-with('XML','X') 结果：false </td> 
 </tr> 
 <tr> 
 <td> fn:substring-before(string1,string2) </td> 
 <td> 返回 string2 在 string1 中出现之前的子字符串。 例子：substring-before('12/10','/') 结果：'12' </td> 
 </tr> 
 <tr> 
 <td> fn:substring-after(string1,string2) </td> 
 <td> 返回 string2 在 string1 中出现之后的子字符串。 例子：substring-after('12/10','/') 结果：'10' </td> 
 </tr> 
 <tr> 
 <td> fn:matches(string,pattern) </td> 
 <td> 如果 string 参数匹配指定的模式，则返回 true，否则返回 false。 例子：matches("Merano", "ran") 结果：true </td> 
 </tr> 
 <tr> 
 <td> fn:replace(string,pattern,replace) </td> 
 <td> 把指定的模式替换为 replace 参数，并返回结果。 例子：replace("Bella Italia", "l", "*") 结果：'Be**a Ita*ia' 例子：replace("Bella Italia", "l", "") 结果：'Bea Itaia' </td> 
 </tr> 
 <tr> 
 <td> fn:tokenize(string,pattern) </td> 
 <td> 例子：tokenize("XPath is fun", "\s+") 结果：("XPath", "is", "fun") </td> 
 </tr> 
 </tbody> 
</table>

# 关于布尔值的函数 #

<table> 
 <tbody> 
 <tr> 
 <td> 名称 </td> 
 <td> 说明 </td> 
 </tr> 
 <tr> 
 <td> fn:boolean(arg) </td> 
 <td> 返回数字、字符串或节点集的布尔值。 </td> 
 </tr> 
 <tr> 
 <td> fn:not(arg) </td> 
 <td> 首先通过 boolean() 函数把参数还原为一个布尔值。如果该布尔值为 false，则返回 true，否则返回 true。 例子：not(true()) 结果：false </td> 
 </tr> 
 <tr> 
 <td> fn:true() </td> 
 <td> 返回布尔值 true。 例子：true() 结果：true </td> 
 </tr> 
 <tr> 
 <td> fn:false() </td> 
 <td> 返回布尔值 false。 例子：false() 结果：false </td> 
 </tr> 
 </tbody> 
</table>

# 有关序列的函数 #

## 一般性的函数 ##

<table> 
 <tbody> 
 <tr> 
 <td> 名称 </td> 
 <td> 说明 </td> 
 </tr> 
 <tr> 
 <td> fn:index-of((item,item,...),searchitem) </td> 
 <td> 返回在项目序列中等于 searchitem 参数的位置。 例子：index-of ((15, 40, 25, 40, 10), 40) 结果：(2, 4) 例子：index-of (("a", "dog", "and", "a", "duck"), "a") Result (1, 4) 例子：index-of ((15, 40, 25, 40, 10), 18) 结果：() </td> 
 </tr> 
 <tr> 
 <td> fn:remove((item,item,...),position) </td> 
 <td> 返回由 item 参数构造的新序列 - 同时删除 position 参数指定的项目。 例子：remove(("ab", "cd", "ef"), 0) 结果：("ab", "cd", "ef") 例子：remove(("ab", "cd", "ef"), 1) 结果：("cd", "ef") 例子：remove(("ab", "cd", "ef"), 4) 结果：("ab", "cd", "ef") </td> 
 </tr> 
 <tr> 
 <td> fn:empty(item,item,...) </td> 
 <td> 如果参数值是空序列，则返回 true，否则返回 false。 例子：empty(remove(("ab", "cd"), 1)) 结果：false </td> 
 </tr> 
 <tr> 
 <td> fn:exists(item,item,...) </td> 
 <td> 如果参数值不是空序列，则返回 true，否则返回 false。 例子：exists(remove(("ab"), 1)) 结果：false </td> 
 </tr> 
 <tr> 
 <td> fn:distinct-values((item,item,...),collation) </td> 
 <td> 返回唯一不同的值。 例子：distinct-values((1, 2, 3, 1, 2)) 结果：(1, 2, 3) </td> 
 </tr> 
 <tr> 
 <td> fn:insert-before((item,item,...),pos,inserts) </td> 
 <td> 返回由 item 参数构造的新序列 - 同时在 pos 参数指定位置插入 inserts 参数的值。 例子：insert-before(("ab", "cd"), 0, "gh") 结果：("gh", "ab", "cd") 例子：insert-before(("ab", "cd"), 1, "gh") 结果：("gh", "ab", "cd") 例子：insert-before(("ab", "cd"), 2, "gh") 结果：("ab", "gh", "cd") 例子：insert-before(("ab", "cd"), 5, "gh") 结果：("ab", "cd", "gh") </td> 
 </tr> 
 <tr> 
 <td> fn:reverse((item,item,...)) </td> 
 <td> 返回指定的项目的颠倒顺序。 例子：reverse(("ab", "cd", "ef")) 结果：("ef", "cd", "ab") 例子：reverse(("ab")) 结果：("ab") </td> 
 </tr> 
 <tr> 
 <td> fn:subsequence((item,item,...),start,len) </td> 
 <td> 返回 start 参数指定的位置返回项目序列，序列的长度由 len 参数指定。第一个项目的位置是 1。 例子：subsequence(($item1, $item2, $item3,...), 3) 结果：($item3, ...) 例子：subsequence(($item1, $item2, $item3, ...), 2, 2) 结果：($item2, $item3) </td> 
 </tr> 
 <tr> 
 <td> fn:unordered((item,item,...)) </td> 
 <td> 依据实现决定的顺序来返回项目。 </td> 
 </tr> 
 </tbody> 
</table>

## 测试序列容量的函数 ##

<table> 
 <tbody> 
 <tr> 
 <td> 名称 </td> 
 <td> 说明 </td> 
 </tr> 
 <tr> 
 <td> fn:zero-or-one(item,item,...) </td> 
 <td> 如果参数包含零个或一个项目，则返回参数，否则生成错误。 </td> 
 </tr> 
 <tr> 
 <td> fn:one-or-more(item,item,...) </td> 
 <td> 如果参数包含一个或多个项目，则返回参数，否则生成错误。 </td> 
 </tr> 
 <tr> 
 <td> fn:exactly-one(item,item,...) </td> 
 <td> 如果参数包含一个项目，则返回参数，否则生成错误。 </td> 
 </tr> 
 </tbody> 
</table>

## Equals, Union, Intersection and Except ##

<table> 
 <tbody> 
 <tr> 
 <td> 名称 </td> 
 <td> 说明 </td> 
 </tr> 
 <tr> 
 <td> fn:deep-equal(param1,param2,collation) </td> 
 <td> 如果 param1 和 param2 与彼此相等（deep-equal），则返回 true，否则返回 false。 </td> 
 </tr> 
 </tbody> 
</table>

## 合计函数 ##

<table> 
 <tbody> 
 <tr> 
 <td> 名称 </td> 
 <td> 说明 </td> 
 </tr> 
 <tr> 
 <td> fn:count((item,item,...)) </td> 
 <td> 返回节点的数量。 </td> 
 </tr> 
 <tr> 
 <td> fn:avg((arg,arg,...)) </td> 
 <td> 返回参数值的平均数。 例子：avg((1,2,3)) 结果：2 </td> 
 </tr> 
 <tr> 
 <td> fn:max((arg,arg,...)) </td> 
 <td> 返回大于其它参数的参数。 例子：max((1,2,3)) 结果：3 例子：max(('a', 'k')) 结果：'k' </td> 
 </tr> 
 <tr> 
 <td> fn:min((arg,arg,...)) </td> 
 <td> 返回小于其它参数的参数。 例子：min((1,2,3)) 结果：1 例子：min(('a', 'k')) 结果：'a' </td> 
 </tr> 
 <tr> 
 <td> fn:sum(arg,arg,...) </td> 
 <td> 返回指定节点集中每个节点的数值的总和。 </td> 
 </tr> 
 </tbody> 
</table>

## 生成序列的函数 ##

<table> 
 <tbody> 
 <tr> 
 <td> 名称 </td> 
 <td> 说明 </td> 
 </tr> 
 <tr> 
 <td> fn:id((string,string,...),node) </td> 
 <td> Returns a sequence of element nodes that have an ID value equal to the value of one or more of the values specified in the string argument </td> 
 </tr> 
 <tr> 
 <td> fn:idref((string,string,...),node) </td> 
 <td> Returns a sequence of element or attribute nodes that have an IDREF value equal to the value of one or more of the values specified in the string argument </td> 
 </tr> 
 <tr> 
 <td> fn:doc(URI) </td> 
 <td> &nbsp; </td> 
 </tr> 
 <tr> 
 <td> fn:doc-available(URI) </td> 
 <td> 如果 doc() 函数返回文档节点，则返回 true，否则返回 false。 </td> 
 </tr> 
 <tr> 
 <td> fn:collection() fn:collection(string) </td> 
 <td> &nbsp; </td> 
 </tr> 
 </tbody> 
</table>

# 上下文函数 #

<table> 
 <tbody> 
 <tr> 
 <td> 名称 </td> 
 <td> 说明 </td> 
 </tr> 
 <tr> 
 <td> fn:position() </td> 
 <td> 返回当前正在被处理的节点的 index 位置。 例子：//book[position()&lt;=3] 结果：选择前三个 book 元素 </td> 
 </tr> 
 <tr> 
 <td> fn:last() </td> 
 <td> 返回在被处理的节点列表中的项目数目。 例子：//book[last()] 结果：选择最后一个 book 元素 </td> 
 </tr> 
 <tr> 
 <td> fn:current-dateTime() </td> 
 <td> 返回当前的 dateTime（带有时区）。 </td> 
 </tr> 
 <tr> 
 <td> fn:current-date() </td> 
 <td> 返回当前的日期（带有时区）。 </td> 
 </tr> 
 <tr> 
 <td> fn:current-time() </td> 
 <td> 返回当前的时间（带有时区）。 </td> 
 </tr> 
 <tr> 
 <td> fn:implicit-timezone() </td> 
 <td> 返回隐式时区的值。 </td> 
 </tr> 
 <tr> 
 <td> fn:default-collation() </td> 
 <td> 返回默认对照的值。 </td> 
 </tr> 
 <tr> 
 <td> fn:static-base-uri() </td> 
 <td> 返回 base-uri 的值。 </td> 
 </tr> 
 </tbody> 
</table>

# 函数示例 #

<table> 
 <tbody> 
 <tr> 
 <td> 名称 </td> 
 <td> 说明 </td> 
 </tr> 
 <tr> 
 <td> //a[not(contains(@href,'detail'))] </td> 
 <td> 返回所有 “href” 属性值不包含 “detail” 的 a 节点 </td> 
 </tr> 
 <tr> 
 <td> //a[starts-with(@href,'//detail.tmall.com')] </td> 
 <td> 返回所有 “href” 属性值以 “//detail.tmall.com” 开始的 a 节点 </td> 
 </tr> 
 <tr> 
 <td> //a[contains(@href,'//store.taobao.com')] </td> 
 <td> 返回所有 “href” 属性值包含 “//store.taobao.com” 的 a 节点 </td> 
 </tr> 
 <tr> 
 <td> //*[contains(@class,'filter') and contains(@class,'clearfix')]/a/text() </td> 
 <td> 获取 “class” 属性值包含 “filter” 并且包含 “clearfix” 的任意元素下的 a 子节点中的文本 </td> 
 </tr> 
 <tr> 
 <td> //b[@class='ui-page-cur']/following-sibling::a[position()=1] </td> 
 <td> 获取 “class” 属性值为 “ui-page-cur” 的 b 节点之后的第一个同胞 a 标签 </td> 
 </tr> 
 </tbody> 
</table>

[http_www.w3school.com.cn_xpath_index.asp]: http://www.w3school.com.cn/xpath/index.asp