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

• 存取
• 錯(cuò)誤和跟蹤
• 數(shù)值
• 字符串

• AnyURI
• 邏輯
• 持續(xù)時(shí)間/日期/時(shí)間
• QName

• 節(jié)點(diǎn)
• 序列
• Context

• fn:base-uri()
• fn:base-uri(node)

• 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"。

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

例子：number('100')

結(jié)果：100

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

例子：abs(3.14)

結(jié)果：3.14

例子：abs(-3.14)

結(jié)果：3.14

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

例子：ceiling(3.14)

結(jié)果：4

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

例子：floor(3.14)

結(jié)果：3

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

例子：round(3.14)

結(jié)果：3

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

結(jié)果：0

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

結(jié)果：2

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

結(jié)果：2

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

例子：string(314)

結(jié)果："314"

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

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

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

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

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

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

• 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

返回字符串的拼接。

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

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

使用 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'

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

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

結(jié)果：'THE XML'

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

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

結(jié)果：'the xml'

把 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'

例子：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"

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

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

結(jié)果：true

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

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

結(jié)果：true

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

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

結(jié)果：false

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

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

結(jié)果：'12'

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

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

結(jié)果：'10'

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

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

結(jié)果：true

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

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

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

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

結(jié)果：'Bea Itaia'

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

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

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

例子：not(true())

結(jié)果：false

返回布爾值 true。

例子：true()

結(jié)果：true

返回布爾值 false。

例子：false()

結(jié)果：false

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

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

結(jié)果：2005

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

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

結(jié)果：01

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

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

結(jié)果：10

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

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

結(jié)果：12

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

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

結(jié)果：30

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

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

結(jié)果：0

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

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

結(jié)果：2005

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

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

結(jié)果：4

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

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

結(jié)果：23

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

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

結(jié)果：10

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

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

結(jié)果：22

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

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

結(jié)果：0

• fn:name()
• fn:name(nodeset)

• fn:local-name()
• fn:local-name(nodeset)

• fn:namespace-uri()
• fn:namespace-uri(nodeset)

如果當(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)

返回在項(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é)果：()

返回由 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")

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

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

結(jié)果：false

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

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

結(jié)果：false

返回唯一不同的值。

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

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

返回由 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")

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

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

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

例子：reverse(("ab"))

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

返回 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:collection()
• fn:collection(string)

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

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

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

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

例子：//book[last()]

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