XPath、XQuery 以及 XSLT 函數(shù)

2021-08-30 14:48 更新

XPath、XQuery 以及 XSLT 函數(shù)函數(shù)參考手冊(cè)


下面的參考手冊(cè)定義了XPath 2.0,XQuery 1.0和XSLT 2.0中的函數(shù)。


函數(shù)參考手冊(cè)

Note 函數(shù)命名空間的默認(rèn)前綴為 fn:

Note 函數(shù)命名空間的 URI為 : http://www.w3.org/2005/xpath-functions

存取函數(shù)

名稱 說(shuō)明
fn:node-name(node) 返回參數(shù)節(jié)點(diǎn)的節(jié)點(diǎn)名稱。
fn:nilled(node) 返回是否拒絕參數(shù)節(jié)點(diǎn)的布爾值。
fn:data(item.item,...) 接受項(xiàng)目序列,并返回原子值序列。
  • fn:base-uri()
  • fn:base-uri(node)
返回當(dāng)前節(jié)點(diǎn)或指定節(jié)點(diǎn)的 base-uri 屬性的值。
fn:document-uri(node) 返回指定節(jié)點(diǎn)的 document-uri 屬性的值。

錯(cuò)誤和跟蹤函數(shù)

名稱 說(shuō)明
  • fn:error()
  • fn:error(error)
  • fn:error(error,description)
  • fn:error(error,description,error-object)

例子:error(fn:QName('http://example.com/test', 'err:toohigh'), 'Error: Price is too high')

結(jié)果:向外部處理環(huán)境返回 http://example.com/test#toohigh 以及字符串 "Error: Price is too high"。

fn:trace(value,label) 用于對(duì)查詢進(jìn)行 debug。

有關(guān)數(shù)值的函數(shù)

名稱 說(shuō)明
fn:number(arg)

返回參數(shù)的數(shù)值。參數(shù)可以是布爾值、字符串或節(jié)點(diǎn)集。

例子:number('100')

結(jié)果:100

fn:abs(num)

返回參數(shù)的絕對(duì)值。

例子:abs(3.14)

結(jié)果:3.14

例子:abs(-3.14)

結(jié)果:3.14

fn:ceiling(num)

返回大于 num 參數(shù)的最小整數(shù)。

例子:ceiling(3.14)

結(jié)果:4

fn:floor(num)

返回不大于 num 參數(shù)的最大整數(shù)。

例子:floor(3.14)

結(jié)果:3

fn:round(num)

把 num 參數(shù)舍入為最接近的整數(shù)。

例子:round(3.14)

結(jié)果:3

fn:round-half-to-even()

例子:round-half-to-even(0.5)

結(jié)果:0

例子:round-half-to-even(1.5)

結(jié)果:2

例子:round-half-to-even(2.5)

結(jié)果:2

有關(guān)字符串的函數(shù)

名稱 說(shuō)明
fn:string(arg)

返回參數(shù)的字符串值。參數(shù)可以是數(shù)字、邏輯值或節(jié)點(diǎn)集。

例子:string(314)

結(jié)果:"314"

fn:codepoints-to-string(int,int,...)

根據(jù)代碼點(diǎn)序列返回字符串。

例子:codepoints-to-string(84, 104, 233, 114, 232, 115, 101)

結(jié)果:'Thérèse'

fn:string-to-codepoints(string)

根據(jù)字符串返回代碼點(diǎn)序列。

例子:string-to-codepoints("Thérèse")

結(jié)果:84, 104, 233, 114, 232, 115, 101

fn:codepoint-equal(comp1,comp2) 根據(jù) Unicode 代碼點(diǎn)對(duì)照,如果 comp1 的值等于 comp2 的值,則返回 true。(http://www.w3.org/2005/02/xpath-functions/collation/codepoint),否則返回 false。
  • fn:compare(comp1,comp2)
  • fn:compare(comp1,comp2,collation)

如果 comp1 小于 comp2,則返回 -1。如果 comp1 等于 comp2,則返回 0。如果 comp1 大于 comp2,則返回 1。(根據(jù)所用的對(duì)照規(guī)則)。

例子:compare('ghi', 'ghi')

結(jié)果:0

fn:concat(string,string,...)

返回字符串的拼接。

例子:concat('XPath ','is ','FUN!')

結(jié)果:'XPath is FUN!'

fn:string-join((string,string,...),sep)

使用 sep 參數(shù)作為分隔符,來(lái)返回 string 參數(shù)拼接后的字符串。

例子:string-join(('We', 'are', 'having', 'fun!'), ' ')

結(jié)果:' We are having fun! '

例子:string-join(('We', 'are', 'having', 'fun!'))

結(jié)果:'Wearehavingfun!'

例子:string-join((), 'sep')

結(jié)果:''

  • fn:substring(string,start,len)
  • fn:substring(string,start)

返回從 start 位置開始的指定長(zhǎng)度的子字符串。第一個(gè)字符的下標(biāo)是 1。如果省略 len 參數(shù),則返回從位置 start 到字符串末尾的子字符串。

例子:substring('Beatles',1,4)

結(jié)果:'Beat'

例子:substring('Beatles',2)

結(jié)果:'eatles'

  • fn:string-length(string)
  • fn:string-length()

返回指定字符串的長(zhǎng)度。如果沒(méi)有 string 參數(shù),則返回當(dāng)前節(jié)點(diǎn)的字符串值的長(zhǎng)度。

例子:string-length('Beatles')

結(jié)果:7

  • fn:normalize-space(string)
  • fn:normalize-space()

刪除指定字符串的開頭和結(jié)尾的空白,并把內(nèi)部的所有空白序列替換為一個(gè),然后返回結(jié)果。如果沒(méi)有 string 參數(shù),則處理當(dāng)前節(jié)點(diǎn)。

例子:normalize-space(' The   XML ')

結(jié)果:'The XML'

fn:normalize-unicode() 執(zhí)行 Unicode 規(guī)格化。
fn:upper-case(string)

把 string 參數(shù)轉(zhuǎn)換為大寫。

例子:upper-case('The XML')

結(jié)果:'THE XML'

fn:lower-case(string)

把 string 參數(shù)轉(zhuǎn)換為小寫。

例子:lower-case('The XML')

結(jié)果:'the xml'

fn:translate(string1,string2,string3)

把 string1 中的 string2 替換為 string3。

例子:translate('12:30','30','45')

結(jié)果:'12:45'

例子:translate('12:30','03','54')

結(jié)果:'12:45'

例子:translate('12:30','0123','abcd')

結(jié)果:'bc:da'

fn:escape-uri(stringURI,esc-res)

例子:escape-uri("http://example.com/test#car", true())

結(jié)果:"http%3A%2F%2Fexample.com%2Ftest#car"

例子:escape-uri("http://example.com/test#car", false())

結(jié)果:"http://example.com/test#car"

例子:escape-uri ("http://example.com/~bébé", false())

結(jié)果:"http://example.com/~b%C3%A9b%C3%A9"

fn:contains(string1,string2)

如果 string1 包含 string2,則返回 true,否則返回 false。

例子:contains('XML','XM')

結(jié)果:true

fn:starts-with(string1,string2)

如果 string1 以 string2 開始,則返回 true,否則返回 false。

例子:starts-with('XML','X')

結(jié)果:true

fn:ends-with(string1,string2)

如果 string1 以 string2 結(jié)尾,則返回 true,否則返回 false。

例子:ends-with('XML','X')

結(jié)果:false

fn:substring-before(string1,string2)

返回 string2 在 string1 中出現(xiàn)之前的子字符串。

例子:substring-before('12/10','/')

結(jié)果:'12'

fn:substring-after(string1,string2)

返回 string2 在 string1 中出現(xiàn)之后的子字符串。

例子:substring-after('12/10','/')

結(jié)果:'10'

fn:matches(string,pattern)

如果 string 參數(shù)匹配指定的模式,則返回 true,否則返回 false。

例子:matches("Merano", "ran")

結(jié)果:true

fn:replace(string,pattern,replace)

把指定的模式替換為 replace 參數(shù),并返回結(jié)果。

例子:replace("Bella Italia", "l", "*")

結(jié)果:'Be**a Ita*ia'

例子:replace("Bella Italia", "l", "")

結(jié)果:'Bea Itaia'

fn:tokenize(string,pattern)

例子:tokenize("XPath is fun", "\s+")

結(jié)果:("XPath", "is", "fun")

針對(duì) anyURI 的函數(shù)

名稱 說(shuō)明
fn:resolve-uri(relative,base)  

關(guān)于布爾值的函數(shù)

名稱 說(shuō)明
fn:boolean(arg) 返回?cái)?shù)字、字符串或節(jié)點(diǎn)集的布爾值。
fn:not(arg)

首先通過(guò) boolean() 函數(shù)把參數(shù)還原為一個(gè)布爾值。如果該布爾值為 false,則返回 true,否則返回 true。

例子:not(true())

結(jié)果:false

fn:true()

返回布爾值 true。

例子:true()

結(jié)果:true

fn:false()

返回布爾值 false。

例子:false()

結(jié)果:false

有關(guān)持續(xù)時(shí)間、日期和時(shí)間的函數(shù)

日期、時(shí)間、持續(xù)時(shí)間的組件提取函數(shù)

名稱 說(shuō)明
fn:dateTime(date,time) 把參數(shù)轉(zhuǎn)換為日期和時(shí)間。
fn:years-from-duration(datetimedur) 返回參數(shù)值的年份部分的整數(shù),以標(biāo)準(zhǔn)詞匯表示法來(lái)表示。
fn:months-from-duration(datetimedur) 返回參數(shù)值的月份部分的整數(shù),以標(biāo)準(zhǔn)詞匯表示法來(lái)表示。
fn:days-from-duration(datetimedur) 返回參數(shù)值的天部分的整數(shù),以標(biāo)準(zhǔn)詞匯表示法來(lái)表示。
fn:hours-from-duration(datetimedur) 返回參數(shù)值的小時(shí)部分的整數(shù),以標(biāo)準(zhǔn)詞匯表示法來(lái)表示。
fn:minutes-from-duration(datetimedur) 返回參數(shù)值的分鐘部分的整數(shù),以標(biāo)準(zhǔn)詞匯表示法來(lái)表示。
fn:seconds-from-duration(datetimedur) 返回參數(shù)值的分鐘部分的十進(jìn)制數(shù),以標(biāo)準(zhǔn)詞匯表示法來(lái)表示。
fn:year-from-dateTime(datetime)

返回參數(shù)本地值的年部分的整數(shù)。

例子:year-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

結(jié)果:2005

fn:month-from-dateTime(datetime)

返回參數(shù)本地值的月部分的整數(shù)。

例子:month-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

結(jié)果:01

fn:day-from-dateTime(datetime)

返回參數(shù)本地值的天部分的整數(shù)。

例子:day-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

結(jié)果:10

fn:hours-from-dateTime(datetime)

返回參數(shù)本地值的小時(shí)部分的整數(shù)。

例子:hours-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

結(jié)果:12

fn:minutes-from-dateTime(datetime)

返回參數(shù)本地值的分鐘部分的整數(shù)。

例子:minutes-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

結(jié)果:30

fn:seconds-from-dateTime(datetime)

返回參數(shù)本地值的秒部分的十進(jìn)制數(shù)。

例子:seconds-from-dateTime(xs:dateTime("2005-01-10T12:30:00-04:10"))

結(jié)果:0

fn:timezone-from-dateTime(datetime) 返回參數(shù)的時(shí)區(qū)部分,如果存在。
fn:year-from-date(date)

返回參數(shù)本地值中表示年的整數(shù)。

例子:year-from-date(xs:date("2005-04-23"))

結(jié)果:2005

fn:month-from-date(date)

返回參數(shù)本地值中表示月的整數(shù)。

例子:month-from-date(xs:date("2005-04-23"))

結(jié)果:4

fn:day-from-date(date)

返回參數(shù)本地值中表示天的整數(shù)。

例子:day-from-date(xs:date("2005-04-23"))

結(jié)果:23

fn:timezone-from-date(date) 返回參數(shù)的時(shí)區(qū)部分,如果存在。
fn:hours-from-time(time)

返回參數(shù)本地值中表示小時(shí)部分的整數(shù)。

例子:hours-from-time(xs:time("10:22:00"))

結(jié)果:10

fn:minutes-from-time(time)

返回參數(shù)本地值中表示分鐘部分的整數(shù)。

例子:minutes-from-time(xs:time("10:22:00"))

結(jié)果:22

fn:seconds-from-time(time)

返回參數(shù)本地值中表示秒部分的整數(shù)。

例子:seconds-from-time(xs:time("10:22:00"))

結(jié)果:0

fn:timezone-from-time(time) 返回參數(shù)的時(shí)區(qū)部分,如果存在。
fn:adjust-dateTime-to-timezone(datetime,timezone) 如果 timezone 參數(shù)為空,則返回沒(méi)有時(shí)區(qū)的 dateTime。否則返回帶有時(shí)區(qū)的 dateTime。
fn:adjust-date-to-timezone(date,timezone) 如果 timezone 參數(shù)為空,則返回沒(méi)有時(shí)區(qū)的 date。否則返回帶有時(shí)區(qū)的 date。
fn:adjust-time-to-timezone(time,timezone) 如果 timezone 參數(shù)為空,則返回沒(méi)有時(shí)區(qū)的 time。否則返回帶有時(shí)區(qū)的 time。

與 QNames 相關(guān)的函數(shù)

名稱 說(shuō)明
fn:QName()  
fn:local-name-from-QName()  
fn:namespace-uri-from-QName()  
fn:namespace-uri-for-prefix()  
fn:in-scope-prefixes()  
fn:resolve-QName()  

關(guān)于節(jié)點(diǎn)的函數(shù)

名稱 說(shuō)明
  • fn:name()
  • fn:name(nodeset)
返回當(dāng)前節(jié)點(diǎn)的名稱或指定節(jié)點(diǎn)集中的第一個(gè)節(jié)點(diǎn)。
  • fn:local-name()
  • fn:local-name(nodeset)
返回當(dāng)前節(jié)點(diǎn)的名稱或指定節(jié)點(diǎn)集中的第一個(gè)節(jié)點(diǎn) - 不帶有命名空間前綴。
  • fn:namespace-uri()
  • fn:namespace-uri(nodeset)
返回當(dāng)前節(jié)點(diǎn)或指定節(jié)點(diǎn)集中第一個(gè)節(jié)點(diǎn)的命名空間 URI。
fn:lang(lang)

如果當(dāng)前節(jié)點(diǎn)的語(yǔ)言匹配指定的語(yǔ)言,則返回 true。

例子:Lang("en") is true for <p xml:lang="en">...</p>

例子:Lang("de") is false for <p xml:lang="en">...</p>

  • fn:root()
  • fn:root(node)
返回當(dāng)前節(jié)點(diǎn)或指定的節(jié)點(diǎn)所屬的節(jié)點(diǎn)樹的根節(jié)點(diǎn)。通常是文檔節(jié)點(diǎn)。

有關(guān)序列的函數(shù)

一般性的函數(shù)

名稱 說(shuō)明
fn:index-of((item,item,...),searchitem)

返回在項(xiàng)目序列中等于 searchitem 參數(shù)的位置。

例子:index-of ((15, 40, 25, 40, 10), 40)

結(jié)果:(2, 4)

例子:index-of (("a", "dog", "and", "a", "duck"), "a")

Result (1, 4)

例子:index-of ((15, 40, 25, 40, 10), 18)

結(jié)果:()

fn:remove((item,item,...),position)

返回由 item 參數(shù)構(gòu)造的新序列 - 同時(shí)刪除 position 參數(shù)指定的項(xiàng)目。

例子:remove(("ab", "cd", "ef"), 0)

結(jié)果:("ab", "cd", "ef")

例子:remove(("ab", "cd", "ef"), 1)

結(jié)果:("cd", "ef")

例子:remove(("ab", "cd", "ef"), 4)

結(jié)果:("ab", "cd", "ef")

fn:empty(item,item,...)

如果參數(shù)值是空序列,則返回 true,否則返回 false。

例子:empty(remove(("ab", "cd"), 1))

結(jié)果:false

fn:exists(item,item,...)

如果參數(shù)值不是空序列,則返回 true,否則返回 false。

例子:exists(remove(("ab"), 1))

結(jié)果:false

fn:distinct-values((item,item,...),collation)

返回唯一不同的值。

例子:distinct-values((1, 2, 3, 1, 2))

結(jié)果:(1, 2, 3)

fn:insert-before((item,item,...),pos,inserts)

返回由 item 參數(shù)構(gòu)造的新序列 - 同時(shí)在 pos 參數(shù)指定位置插入 inserts 參數(shù)的值。

例子:insert-before(("ab", "cd"), 0, "gh")

結(jié)果:("gh", "ab", "cd")

例子:insert-before(("ab", "cd"), 1, "gh")

結(jié)果:("gh", "ab", "cd")

例子:insert-before(("ab", "cd"), 2, "gh")

結(jié)果:("ab", "gh", "cd")

例子:insert-before(("ab", "cd"), 5, "gh")

結(jié)果:("ab", "cd", "gh")

fn:reverse((item,item,...))

返回指定的項(xiàng)目的顛倒順序。

例子:reverse(("ab", "cd", "ef"))

結(jié)果:("ef", "cd", "ab")

例子:reverse(("ab"))

結(jié)果:("ab")

fn:subsequence((item,item,...),start,len)

返回 start 參數(shù)指定的位置返回項(xiàng)目序列,序列的長(zhǎng)度由 len 參數(shù)指定。第一個(gè)項(xiàng)目的位置是 1。

例子:subsequence(($item1, $item2, $item3,...), 3)

結(jié)果:($item3, ...)

例子:subsequence(($item1, $item2, $item3, ...), 2, 2)

結(jié)果:($item2, $item3)

fn:unordered((item,item,...)) 依據(jù)實(shí)現(xiàn)決定的順序來(lái)返回項(xiàng)目。

測(cè)試序列容量的函數(shù)

名稱 說(shuō)明
fn:zero-or-one(item,item,...) 如果參數(shù)包含零個(gè)或一個(gè)項(xiàng)目,則返回參數(shù),否則生成錯(cuò)誤。
fn:one-or-more(item,item,...) 如果參數(shù)包含一個(gè)或多個(gè)項(xiàng)目,則返回參數(shù),否則生成錯(cuò)誤。
fn:exactly-one(item,item,...) 如果參數(shù)包含一個(gè)項(xiàng)目,則返回參數(shù),否則生成錯(cuò)誤。

Equals, Union, Intersection and Except

名稱 說(shuō)明
fn:deep-equal(param1,param2,collation) 如果 param1 和 param2 與彼此相等(deep-equal),則返回 true,否則返回 false。

合計(jì)函數(shù)

名稱 說(shuō)明
fn:count((item,item,...)) 返回節(jié)點(diǎn)的數(shù)量。
fn:avg((arg,arg,...)) 返回參數(shù)值的平均數(shù)。 例子:avg((1,2,3)) 結(jié)果:2
fn:max((arg,arg,...)) 返回大于其它參數(shù)的參數(shù)。 例子:max((1,2,3)) 結(jié)果:3 例子:max(('a', 'k')) 結(jié)果:'k'
fn:min((arg,arg,...)) 返回小于其它參數(shù)的參數(shù)。 例子:min((1,2,3)) 結(jié)果:1 例子:min(('a', 'k')) 結(jié)果:'a'
fn:sum(arg,arg,...) 返回指定節(jié)點(diǎn)集中每個(gè)節(jié)點(diǎn)的數(shù)值的總和。

生成序列的函數(shù)

名稱 說(shuō)明
fn:id((string,string,...),node) 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
fn:idref((string,string,...),node) 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
fn:doc(URI)  
fn:doc-available(URI) 如果 doc() 函數(shù)返回文檔節(jié)點(diǎn),則返回 true,否則返回 false。
  • fn:collection()
  • fn:collection(string)
 

上下文函數(shù)

名稱 說(shuō)明
fn:position()

返回當(dāng)前正在被處理的節(jié)點(diǎn)的 index 位置。

例子://book[position()<=3]

結(jié)果:選擇前三個(gè) book 元素

fn:last()

返回在被處理的節(jié)點(diǎn)列表中的項(xiàng)目數(shù)目。

例子://book[last()]

結(jié)果:選擇最后一個(gè) book 元素

fn:current-dateTime() 返回當(dāng)前的 dateTime(帶有時(shí)區(qū))。
fn:current-date() 返回當(dāng)前的日期(帶有時(shí)區(qū))。
fn:current-time() 返回當(dāng)前的時(shí)間(帶有時(shí)區(qū))。
fn:implicit-timezone() 返回隱式時(shí)區(qū)的值。
fn:default-collation() 返回默認(rèn)對(duì)照的值。
fn:static-base-uri() 返回 base-uri 的值。
以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)