XML 參考手冊

• Element (max. one)
• ProcessingInstruction
• Comment
• DocumentType

• ProcessingInstruction
• Comment
• Text
• CDATASection
• EntityReference

• ProcessingInstruction
• Comment
• Text
• CDATASection
• EntityReference

• Text
• Comment
• ProcessingInstruction
• CDATASection
• EntityReference

• Text
• EntityReference

• ProcessingInstruction
• Comment
• Text
• CDATASection
• EntityReference

返回與節點上的鍵關聯的對象。

必須首先將對象設置到此節點，通過使用相同的鍵調用 setUserData。

normalize() 方法移除空的文本節點，并連接相鄰的文本節點。

將元素下的所有文本節點（包括屬性）正規化，其中僅結構（例如元素、注釋、處理指令、CDATA 部分和實體引用）分隔文本節點。

即，既不存在相鄰的文本節點，也不存在空的文本節點。

如果在文檔中設置了該屬性值，則返回 true；

如果屬性值是 DTD/Schema 中的默認值，則返回 false。

指定請求的類型、URL、是否應異步處理請求以及請求的其他可選屬性。

• method: 請求類型：GET 或 POST
• url: 文件在服務器上的位置
• async: true（異步）或 false（同步）

將請求發送到服務器。

string：僅用于 POST 請求

保存 XMLHttpRequest 的狀態。從 0 到 4 的變化：

• 0: 請求未初始化
• 1: 服務器連接已建立
• 2: 請求收到
• 3: 請求處理中
• 4: 請求已完成，響應已就緒

• 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')

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

返回參數的數值。參數可以是布爾值、字符串或節點集。

例子：number('100')

結果：100

返回參數的絕對值。

例子：abs(3.14)

結果：3.14

例子：abs(-3.14)

結果：3.14

返回大于 num 參數的最小整數。

例子：ceiling(3.14)

結果：4

返回不大于 num 參數的最大整數。

例子：floor(3.14)

結果：3

把 num 參數舍入為最接近的整數。

例子：round(3.14)

結果：3

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

結果：0

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

結果：2

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

結果：2

返回參數的字符串值。參數可以是數字、邏輯值或節點集。

例子：string(314)

結果："314"

根據代碼點序列返回字符串。

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

結果：'Thérèse'

根據字符串返回代碼點序列。

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

結果：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。（根據所用的對照規則）。

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

結果：0

返回字符串的拼接。

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

結果：'XPath is FUN!'

使用 sep 參數作為分隔符，來返回 string 參數拼接后的字符串。

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

結果：' We are having fun! '

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

結果：'Wearehavingfun!'

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

結果：''

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

返回從 start 位置開始的指定長度的子字符串。第一個字符的下標是 1。如果省略 len 參數，則返回從位置 start 到字符串末尾的子字符串。

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

結果：'Beat'

例子：substring('Beatles',2)

結果：'eatles'

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

返回指定字符串的長度。如果沒有 string 參數，則返回當前節點的字符串值的長度。

例子：string-length('Beatles')

結果：7

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

刪除指定字符串的開頭和結尾的空白，并把內部的所有空白序列替換為一個，然后返回結果。如果沒有 string 參數，則處理當前節點。

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

結果：'The XML'

把 string 參數轉換為大寫。

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

結果：'THE XML'

把 string 參數轉換為小寫。

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

結果：'the xml'

把 string1 中的 string2 替換為 string3。

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

結果：'12:45'

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

結果：'12:45'

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

結果：'bc:da'

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

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

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

結果：true

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

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

結果：true

如果 string1 以 string2 結尾，則返回 true，否則返回 false。

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

結果：false

返回 string2 在 string1 中出現之前的子字符串。

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

結果：'12'

返回 string2 在 string1 中出現之后的子字符串。

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

結果：'10'

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

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

結果：true

把指定的模式替換為 replace 參數，并返回結果。

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

結果：'Be**a Ita*ia'

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

結果：'Bea Itaia'

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

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

首先通過 boolean() 函數把參數還原為一個布爾值。

如果該布爾值為 false，則返回 true，否則返回 true。

例子：not(true())

結果：false

返回布爾值 true。

例子：true()

結果：true

返回布爾值 false。

例子：false()

結果：false

返回參數本地值的年部分的整數。

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

結果：2005

返回參數本地值的月部分的整數。

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

結果：01

返回參數本地值的天部分的整數。

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

結果：10

返回參數本地值的小時部分的整數。

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

結果：12

返回參數本地值的分鐘部分的整數。

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

結果：30

返回參數本地值的秒部分的十進制數。

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

結果：0

返回參數本地值中表示年的整數。

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

結果：2005

返回參數本地值中表示月的整數。

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

結果：4

返回參數本地值中表示天的整數。

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

結果：23

返回參數本地值中表示小時部分的整數。

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

結果：10

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

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

結果：22

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

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

結果：0

如果 timezone 參數為空，則返回沒有時區的 dateTime。

否則返回帶有時區的 dateTime。

如果 timezone 參數為空，則返回沒有時區的 date。

否則返回帶有時區的 date。

如果 timezone 參數為空，則返回沒有時區的 time。

否則返回帶有時區的 time。

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

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

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

如果當前節點的語言匹配指定的語言，則返回 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)

返回在項目序列中等于 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)

結果：()

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

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

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

結果：false

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

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

結果：false

返回唯一不同的值。

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

結果：(1, 2, 3)

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

返回指定的項目的顛倒順序。

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

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

例子：reverse(("ab"))

結果：("ab")

返回 start 參數指定的位置返回項目序列，序列的長度由 len 參數指定。

第一個項目的位置是 1。

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

結果：($item3, ...)

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

結果：($item2, $item3)

返回參數值的平均數。

例子：avg((1,2,3))

結果：2

返回大于其它參數的參數。

例子：max((1,2,3))

結果：3

例子：max(('a', 'k'))

結果：'k'

返回小于其它參數的參數。

例子：min((1,2,3))

結果：1

例子：min(('a', 'k'))

結果：'a'

• fn:collection()
• fn:collection(string)

返回當前正在被處理的節點的 index 位置。

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

結果：選擇前三個 book 元素

返回在被處理的節點列表中的項目數目。

例子：//book[last()]

結果：選擇最后一個 book 元素