xpath

一我的的天空

隨筆 - 895  文章 - 0  評論 - 109 

博客園   首頁   新隨筆   聯繫   管理   訂閱 

XPath教程

XPath 簡介

XPath 是一門在 XML 文檔中查找信息的語言。XPath 可用來在 XML 文檔中對元素和屬性進行遍歷。

XPath 是 W3C XSLT 標準的主要元素，而且 XQuery 和 XPointer 同時被構建於 XPath 表達之上。

所以，對 XPath 的理解是不少高級 XML 應用的基礎。

 

在學習以前應該具有的知識：

在您繼續學習以前，應該對下面的知識有基本的瞭解：

• HTML / XHTML
• XML / XML 命名空間

什麼是 XPath?

• XPath 使用路徑表達式在 XML 文檔中進行導航
• XPath 包含一個標準函數庫
• XPath 是 XSLT 中的主要元素
• XPath 是一個 W3C 標準

XPath 路徑表達式

XPath 使用路徑表達式來選取 XML 文檔中的節點或者節點集。這些路徑表達式和咱們在常規的電腦文件系統中看到的表達式很是類似。

XPath 標準函數

XPath 含有超過 100 個內建的函數。這些函數用於字符串值、數值、日期和時間比較、節點和 QName 處理、序列處理、邏輯值等等。

XPath 在 XSLT 中使用

XPath 是 XSLT 標準中的主要元素。若是沒有 XPath 方面的知識，您就沒法建立 XSLT 文檔。

XQuery 和 XPointer 均構建於 XPath 表達式之上。XQuery 1.0 和 XPath 2.0 共享相同的數據模型，並支持相同的函數和運算符。

XPath 是 W3C 標準

XPath 於 1999 年 11 月 16 日 成爲 W3C 標準。

XPath 被設計爲供 XSLT、XPointer 以及其餘 XML 解析軟件使用。

 

XPath 節點

在 XPath 中，有七種類型的節點：元素、屬性、文本、命名空間、處理指令、註釋以及文檔節點（或成爲根節點）。

XPath 術語

節點（Node）

在 XPath 中，有七種類型的節點：元素、屬性、文本、命名空間、處理指令、註釋以及文檔（根）節點。XML 文檔是被做爲節點樹來對待的。樹的根被稱爲文檔節點或者根節點。

請看下面這個 XML 文檔：

<?xml version="1.0" encoding="ISO-8859-1"?>

<bookstore>

<book>
  <title lang="en">Harry Potter</title>
  <author>J K. Rowling</author> 
  <year>2005</year>
  <price>29.99</price>
</book>

</bookstore>

上面的XML文檔中的節點例子：

<bookstore> （文檔節點）
<author>J K. Rowling</author> （元素節點）
lang="en" （屬性節點）

基本值（或稱原子值，Atomic value）

基本值是無父或無子的節點。

基本值的例子：

J K. Rowling
"en"

項目（Item）

項目是基本值或者節點。

節點關係

父（Parent）

每一個元素以及屬性都有一個父。

在下面的例子中，book 元素是 title、author、year 以及 price 元素的父：

<book>
  <title>Harry Potter</title>
  <author>J K. Rowling</author>
  <year>2005</year>
  <price>29.99</price>
</book>

子（Children）

元素節點可有零個、一個或多個子。

在下面的例子中，title、author、year 以及 price 元素都是 book 元素的子：

<book>
  <title>Harry Potter</title>
  <author>J K. Rowling</author>
  <year>2005</year>
  <price>29.99</price>
</book>

同胞（Sibling）

擁有相同的父的節點

在下面的例子中，title、author、year 以及 price 元素都是同胞：

<book>
  <title>Harry Potter</title>
  <author>J K. Rowling</author>
  <year>2005</year>
  <price>29.99</price>
</book>

先輩（Ancestor）

某節點的父、父的父，等等。

在下面的例子中，title 元素的先輩是 book 元素和 bookstore 元素：

<bookstore>

<book>
  <title>Harry Potter</title>
  <author>J K. Rowling</author>
  <year>2005</year>
  <price>29.99</price>
</book>

</bookstore>

後代（Descendant）

某個節點的子，子的子，等等。

在下面的例子中，bookstore 的後代是 book、title、author、year 以及 price 元素：

<bookstore>

<book>
  <title>Harry Potter</title>
  <author>J K. Rowling</author>
  <year>2005</year>
  <price>29.99</price>
</book>

</bookstore>

 

 

XPath 語法

XPath 使用路徑表達式來選取 XML 文檔中的節點或節點集。節點是經過沿着路徑 (path) 或者步 (steps) 來選取的。

XML 實例文檔

咱們將在下面的例子中使用這個 XML 文檔。

<?xml version="1.0" encoding="ISO-8859-1"?>

<bookstore>

<book>
  <title lang="eng">Harry Potter</title>
  <price>29.99</price>
</book>

<book>
  <title lang="eng">Learning XML</title>
  <price>39.95</price>
</book>

</bookstore>

選取節點

XPath 使用路徑表達式在 XML 文檔中選取節點。節點是經過沿着路徑或者 step 來選取的。

下面列出了最有用的路徑表達式：

表達式	描述
nodename	選取此節點的全部子節點。
/	從根節點選取。
//	從匹配選擇的當前節點選擇文檔中的節點，而不考慮它們的位置。
.	選取當前節點。
..	選取當前節點的父節點。
@	選取屬性。

實例

在下面的表格中，咱們已列出了一些路徑表達式以及表達式的結果：

路徑表達式	結果
bookstore	選取 bookstore 元素的全部子節點。
/bookstore	選取根元素 bookstore。 註釋：假如路徑起始於正斜槓( / )，則此路徑始終表明到某元素的絕對路徑！
bookstore/book	選取屬於 bookstore 的子元素的全部 book 元素。
//book	選取全部 book 子元素，而無論它們在文檔中的位置。
bookstore//book	選擇屬於 bookstore 元素的後代的全部 book 元素，而無論它們位於 bookstore 之下的什麼位置。
//@lang	選取名爲 lang 的全部屬性。

謂語（Predicates）

謂語用來查找某個特定的節點或者包含某個指定的值的節點。

謂語被嵌在方括號中。

實例

在下面的表格中，咱們列出了帶有謂語的一些路徑表達式，以及表達式的結果：

路徑表達式	結果
/bookstore/book[1]	選取屬於 bookstore 子元素的第一個 book 元素。
/bookstore/book[last()]	選取屬於 bookstore 子元素的最後一個 book 元素。
/bookstore/book[last()-1]	選取屬於 bookstore 子元素的倒數第二個 book 元素。
/bookstore/book[position()<3]	選取最前面的兩個屬於 bookstore 元素的子元素的 book 元素。
//title[@lang]	選取全部擁有名爲 lang 的屬性的 title 元素。
//title[@lang='eng']	選取全部 title 元素，且這些元素擁有值爲 eng 的 lang 屬性。
/bookstore/book[price>35.00]	選取 bookstore 元素的全部 book 元素，且其中的 price 元素的值須大於 35.00。
/bookstore/book[price>35.00]/title	選取 bookstore 元素中的 book 元素的全部 title 元素，且其中的 price 元素的值須大於 35.00。

選取未知節點

XPath 通配符可用來選取未知的 XML 元素。

通配符	描述
*	匹配任何元素節點。
@*	匹配任何屬性節點。
node()	匹配任何類型的節點。

實例

在下面的表格中，咱們列出了一些路徑表達式，以及這些表達式的結果：

路徑表達式	結果
/bookstore/*	選取 bookstore 元素的全部子元素。
//*	選取文檔中的全部元素。
//title[@*]	選取全部帶有屬性的 title 元素。

選取若干路徑

經過在路徑表達式中使用「|」運算符，您能夠選取若干個路徑。

實例

在下面的表格中，咱們列出了一些路徑表達式，以及這些表達式的結果：

路徑表達式	結果
//book/title | //book/price	選取 book 元素的全部 title 和 price 元素。
//title | //price	選取文檔中的全部 title 和 price 元素。
/bookstore/book/title | //price	選取屬於 bookstore 元素的 book 元素的全部 title 元素，以及文檔中全部的 price 元素。

 

XPath Axes（座標軸）

XML 實例文檔

咱們將在下面的例子中使用此 XML 文檔：

<?xml version="1.0" encoding="ISO-8859-1"?>

<bookstore>

<book>
  <title lang="eng">Harry Potter</title>
  <price>29.99</price>
</book>

<book>
  <title lang="eng">Learning XML</title>
  <price>39.95</price>
</book>

</bookstore>

XPath 軸

軸可定義相對於當前節點的節點集。

軸名稱	結果
ancestor	選取當前節點的全部先輩（父、祖父等）。
ancestor-or-self	選取當前節點的全部先輩（父、祖父等）以及當前節點自己。
attribute	選取當前節點的全部屬性。
child	選取當前節點的全部子元素。
descendant	選取當前節點的全部後代元素（子、孫等）。
descendant-or-self	選取當前節點的全部後代元素（子、孫等）以及當前節點自己。
following	選取文檔中當前節點的結束標籤以後的全部節點。
namespace	選取當前節點的全部命名空間節點。
parent	選取當前節點的父節點。
preceding	選取文檔中當前節點的開始標籤以前的全部節點。
preceding-sibling	選取當前節點以前的全部同級節點。
self	選取當前節點。

位置路徑表達式

位置路徑能夠是絕對的，也能夠是相對的。

絕對路徑起始於正斜槓( / )，而相對路徑不會這樣。在兩種狀況中，位置路徑均包括一個或多個步，每一個步均被斜槓分割：

絕對位置路徑：

/step/step/...

相對位置路徑：

step/step/...

每一個步均根據當前節點集之中的節點來進行計算。

步（step）包括：

    軸（axis）

    定義所選節點與當前節點之間的樹關係

    節點測試（node-test）

    識別某個軸內部的節點

    零個或者更多謂語（predicate）

    更深刻地提煉所選的節點集

步的語法：

    軸名稱::節點測試[謂語]

實例

例子	結果
child::book	選取全部屬於當前節點的子元素的 book 節點。
attribute::lang	選取當前節點的 lang 屬性。
child::*	選取當前節點的全部子元素。
attribute::*	選取當前節點的全部屬性。
child::text()	選取當前節點的全部文本子節點。
child::node()	選取當前節點的全部子節點。
descendant::book	選取當前節點的全部 book 後代。
ancestor::book	選擇當前節點的全部 book 先輩。
ancestor-or-self::book	選取當前節點的全部 book 先輩以及當前節點（若是此節點是 book 節點）
child::*/child::price	選取當前節點的全部 price 孫節點。

 

XPath 運算符

XPath 表達式可返回節點集、字符串、邏輯值以及數字。

XPath 運算符

下面列出了可用在 XPath 表達式中的運算符：

運算符	描述	實例	返回值
|	計算兩個節點集	//book | //cd	返回全部擁有 book 和 cd 元素的節點集
+	加法	6 + 4	10
-	減法	6 - 4	2
*	乘法	6 * 4	24
div	除法	8 div 4	2
=	等於	price=9.80	若是 price 是 9.80，則返回 true。 若是 price 是 9.90，則返回 false。
!=	不等於	price!=9.80	若是 price 是 9.90，則返回 true。 若是 price 是 9.80，則返回 false。
<	小於	price<9.80	若是 price 是 9.00，則返回 true。 若是 price 是 9.90，則返回 false。
<=	小於或等於	price<=9.80	若是 price 是 9.00，則返回 true。 若是 price 是 9.90，則返回 false。
>	大於	price>9.80	若是 price 是 9.90，則返回 true。 若是 price 是 9.80，則返回 false。
>=	大於或等於	price>=9.80	若是 price 是 9.90，則返回 true。 若是 price 是 9.70，則返回 false。
or	或	price=9.80 or price=9.70	若是 price 是 9.80，則返回 true。 若是 price 是 9.50，則返回 false。
and	與	price>9.00 and price<9.90	若是 price 是 9.80，則返回 true。 若是 price 是 8.50，則返回 false。
mod	計算除法的餘數	5 mod 2	1

 

XPath 實例

在本節，讓咱們經過實例來學習一些基礎的 XPath 語法。

XML實例文檔

咱們將在下面的例子中使用這個 XML 文檔：

"books.xml" :

<?xml version="1.0" encoding="ISO-8859-1"?>

<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>
  <author>Per Bothner</author>
  <author>Kurt Cagle</author>
  <author>James Linn</author>
  <author>Vaidyanathan Nagarajan</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>

加載 XML 文檔

全部現代瀏覽器都支持使用 XMLHttpRequest 來加載 XML 文檔的方法。

針對大多數現代瀏覽器的代碼：

var xmlhttp=new XMLHttpRequest()

針對古老的微軟瀏覽器（IE 5 和 6）的代碼：

var xmlhttp=new ActiveXObject("Microsoft.XMLHTTP")

選取節點

不幸的是，Internet Explorer 和其餘處理 XPath 的方式不一樣。

在咱們的例子中，包含適用於大多數主流瀏覽器的代碼。

Internet Explorer 使用 selectNodes() 方法從 XML 文檔中的選取節點：

xmlDoc.selectNodes(xpath);

Firefox、Chrome、Opera 以及 Safari 使用 evaluate() 方法從 XML 文檔中選取節點：

xmlDoc.evaluate(xpath, xmlDoc, null, XPathResult.ANY_TYPE,null);

選取全部 title

下面的例子選取全部 title 節點：

/bookstore/book/title

選取第一個 book 的 title

下面的例子選取 bookstore 元素下面的第一個 book 節點的 title：

/bookstore/book[1]/title

這裏有一個問題。上面的例子在 IE 和其餘瀏覽器中輸出不一樣的結果。

IE5 以及更高版本將 [0] 視爲第一個節點，而根據 W3C 的標準，應該是 [1]。

爲了解決 IE5+ 中 [0] 和 [1] 的問題，能夠爲 XPath 設置語言選擇（SelectionLanguage）。

下面的例子選取 bookstore 元素下面的第一個 book 節點的 title：

xml.setProperty("SelectionLanguage","XPath");
xml.selectNodes("/bookstore/book[1]/title");

選取全部價格

下面的例子選取 price 節點中的全部文本：

/bookstore/book/price/text()

選取價格高於 35 的 price 節點

下面的例子選取價格高於 35 的全部 price 節點：

/bookstore/book[price>35]/price

選取價格高於 35 的 title 節點

下面的例子選取價格高於 35 的全部 title 節點：

/bookstore/book[price>35]/title

選取全部的 book 節點

下面的這個例子選取了 bookstore 元素下全部的 book 節點：

xmlDoc.selectNodes("/bookstore/book")

選取第一個 book 節點

下面的例子僅選取 bookstore 元素下第一個 book 節點：

xmlDoc.selectNodes("/bookstore/book[0]")

選取 price

下面的例子從全部的 price 節點選取文本：

xmlDoc.selectNodes("/bookstore/book/price/text()")

選取價格高於 35 的 price 價格

下面的例子會選取全部價格高於 35 的 price 節點：

xmlDoc.selectNodes("/bookstore/book[price>35]/price")

選取價格高於 35 的 title 節點

下面的例子會選取全部價格高於 35 的 title 節點：

xmlDoc.selectNodes("/bookstore/book[price>35]/title")

 

 

參考手冊

XPath、XQuery 以及 XSLT 函數

存取函數

名稱	說明
fn:node-name(node)	返回參數節點的節點名稱。
fn:nilled(node)	返回是否拒絕參數節點的布爾值。
fn:data(item.item,...)	接受項目序列，並返回原子值序列。
fn:base-uri() fn:base-uri(node)	返回當前節點或指定節點的 base-uri 屬性的值。
fn:document-uri(node)	返回指定節點的 document-uri 屬性的值。

錯誤和跟蹤函數

名稱	說明
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"。
fn:trace(value,label)	用於對查詢進行 debug。

有關數值的函數

名稱	說明
fn:number(arg)	返回參數的數值。參數能夠是布爾值、字符串或節點集。 例子：number('100') 結果：100
fn:abs(num)	返回參數的絕對值。 例子：abs(3.14) 結果：3.14 例子：abs(-3.14) 結果：3.14
fn:ceiling(num)	返回大於 num 參數的最小整數。 例子：ceiling(3.14) 結果：4
fn:floor(num)	返回不大於 num 參數的最大整數。 例子：floor(3.14) 結果：3
fn:round(num)	把 num 參數舍入爲最接近的整數。 例子：round(3.14) 結果：3
fn:round-half-to-even()	例子：round-half-to-even(0.5) 結果：0 例子：round-half-to-even(1.5) 結果：2 例子：round-half-to-even(2.5) 結果：2

有關字符串的函數

名稱	說明
fn:string(arg)	返回參數的字符串值。參數能夠是數字、邏輯值或節點集。 例子：string(314) 結果："314"
fn:codepoints-to-string(int,int,...)	根據代碼點序列返回字符串。 例子：codepoints-to-string(84, 104, 233, 114, 232, 115, 101) 結果：'Thérèse'
fn:string-to-codepoints(string)	根據字符串返回代碼點序列。 例子：string-to-codepoints("Thérèse") 結果：84, 104, 233, 114, 232, 115, 101
fn:codepoint-equal(comp1,comp2)	根據 Unicode 代碼點對照，若是 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。（根據所用的對照規則）。 例子：compare('ghi', 'ghi') 結果：0
fn:concat(string,string,...)	返回字符串的拼接。 例子：concat('XPath ','is ','FUN!') 結果：'XPath is FUN!'
fn:string-join((string,string,...),sep)	使用 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'
fn:normalize-unicode()	執行 Unicode 規格化。
fn:upper-case(string)	把 string 參數轉換爲大寫。 例子：upper-case('The XML') 結果：'THE XML'
fn:lower-case(string)	把 string 參數轉換爲小寫。 例子：lower-case('The XML') 結果：'the xml'
fn:translate(string1,string2,string3)	把 string1 中的 string2 替換爲 string3。 例子：translate('12:30','30','45') 結果：'12:45' 例子：translate('12:30','03','54') 結果：'12:45' 例子：translate('12:30','0123','abcd') 結果：'bc:da'
fn:escape-uri(stringURI,esc-res)	例子：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"
fn:contains(string1,string2)	若是 string1 包含 string2，則返回 true，不然返回 false。 例子：contains('XML','XM') 結果：true
fn:starts-with(string1,string2)	若是 string1 以 string2 開始，則返回 true，不然返回 false。 例子：starts-with('XML','X') 結果：true
fn:ends-with(string1,string2)	若是 string1 以 string2 結尾，則返回 true，不然返回 false。 例子：ends-with('XML','X') 結果：false
fn:substring-before(string1,string2)	返回 string2 在 string1 中出現以前的子字符串。 例子：substring-before('12/10','/') 結果：'12'
fn:substring-after(string1,string2)	返回 string2 在 string1 中出現以後的子字符串。 例子：substring-after('12/10','/') 結果：'10'
fn:matches(string,pattern)	若是 string 參數匹配指定的模式，則返回 true，不然返回 false。 例子：matches("Merano", "ran") 結果：true
fn:replace(string,pattern,replace)	把指定的模式替換爲 replace 參數，並返回結果。 例子：replace("Bella Italia", "l", "*") 結果：'Be**a Ita*ia' 例子：replace("Bella Italia", "l", "") 結果：'Bea Itaia'
fn:tokenize(string,pattern)	例子：tokenize("XPath is fun", "\s+") 結果：("XPath", "is", "fun")

針對 anyURI 的函數

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

關於布爾值的函數

名稱	說明
fn:boolean(arg)	返回數字、字符串或節點集的布爾值。
fn:not(arg)	首先經過 boolean() 函數把參數還原爲一個布爾值。若是該布爾值爲 false，則返回 true，不然返回 true。 例子：not(true()) 結果：false
fn:true()	返回布爾值 true。 例子：true() 結果：true
fn:false()	返回布爾值 false。 例子：false() 結果：false

有關持續時間、日期和時間的函數

日期、時間、持續時間的組件提取函數

名稱	說明
fn:dateTime(date,time)	把參數轉換爲日期和時間。
fn:years-from-duration(datetimedur)	返回參數值的年份部分的整數，以標準詞彙表示法來表示。
fn:months-from-duration(datetimedur)	返回參數值的月份部分的整數，以標準詞彙表示法來表示。
fn:days-from-duration(datetimedur)	返回參數值的天部分的整數，以標準詞彙表示法來表示。
fn:hours-from-duration(datetimedur)	返回參數值的小時部分的整數，以標準詞彙表示法來表示。
fn:minutes-from-duration(datetimedur)	返回參數值的分鐘部分的整數，以標準詞彙表示法來表示。
fn:seconds-from-duration(datetimedur)	返回參數值的分鐘部分的十進制數，以標準詞彙表示法來表示。
fn:year-from-dateTime(datetime)	返回參數本地值的年部分的整數。 例子：year-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10")) 結果：2005
fn:month-from-dateTime(datetime)	返回參數本地值的月部分的整數。 例子：month-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10")) 結果：01
fn:day-from-dateTime(datetime)	返回參數本地值的天部分的整數。 例子：day-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10")) 結果：10
fn:hours-from-dateTime(datetime)	返回參數本地值的小時部分的整數。 例子：hours-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10")) 結果：12
fn:minutes-from-dateTime(datetime)	返回參數本地值的分鐘部分的整數。 例子：minutes-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10")) 結果：30
fn:seconds-from-dateTime(datetime)	返回參數本地值的秒部分的十進制數。 例子：seconds-from-dateTime(xs:dateTime("2005-01-10T12:30:00-04:10")) 結果：0
fn:timezone-from-dateTime(datetime)	返回參數的時區部分，若是存在。
fn:year-from-date(date)	返回參數本地值中表示年的整數。 例子：year-from-date(xs:date("2005-04-23")) 結果：2005
fn:month-from-date(date)	返回參數本地值中表示月的整數。 例子：month-from-date(xs:date("2005-04-23")) 結果：4
fn:day-from-date(date)	返回參數本地值中表示天的整數。 例子：day-from-date(xs:date("2005-04-23")) 結果：23
fn:timezone-from-date(date)	返回參數的時區部分，若是存在。
fn:hours-from-time(time)	返回參數本地值中表示小時部分的整數。 例子：hours-from-time(xs:time("10:22:00")) 結果：10
fn:minutes-from-time(time)	返回參數本地值中表示分鐘部分的整數。 例子：minutes-from-time(xs:time("10:22:00")) 結果：22
fn:seconds-from-time(time)	返回參數本地值中表示秒部分的整數。 例子：seconds-from-time(xs:time("10:22:00")) 結果：0
fn:timezone-from-time(time)	返回參數的時區部分，若是存在。
fn:adjust-dateTime-to-timezone(datetime,timezone)	若是 timezone 參數爲空，則返回沒有時區的 dateTime。不然返回帶有時區的 dateTime。
fn:adjust-date-to-timezone(date,timezone)	若是 timezone 參數爲空，則返回沒有時區的 date。不然返回帶有時區的 date。
fn:adjust-time-to-timezone(time,timezone)	若是 timezone 參數爲空，則返回沒有時區的 time。不然返回帶有時區的 time。

與 QNames 相關的函數

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

關於節點的函數

名稱	說明
fn:name() fn:name(nodeset)	返回當前節點的名稱或指定節點集中的第一個節點。
fn:local-name() fn:local-name(nodeset)	返回當前節點的名稱或指定節點集中的第一個節點 - 不帶有命名空間前綴。
fn:namespace-uri() fn:namespace-uri(nodeset)	返回當前節點或指定節點集中第一個節點的命名空間 URI。
fn:lang(lang)	若是當前節點的語言匹配指定的語言，則返回 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)	返回當前節點或指定的節點所屬的節點樹的根節點。一般是文檔節點。

有關序列的函數

通常性的函數

名稱	說明
fn:index-of((item,item,...),searchitem)	返回在項目序列中等於 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) 結果：()
fn:remove((item,item,...),position)	返回由 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")
fn:empty(item,item,...)	若是參數值是空序列，則返回 true，不然返回 false。 例子：empty(remove(("ab", "cd"), 1)) 結果：false
fn:exists(item,item,...)	若是參數值不是空序列，則返回 true，不然返回 false。 例子：exists(remove(("ab"), 1)) 結果：false
fn:distinct-values((item,item,...),collation)	返回惟一不一樣的值。 例子：distinct-values((1, 2, 3, 1, 2)) 結果：(1, 2, 3)
fn:insert-before((item,item,...),pos,inserts)	返回由 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")
fn:reverse((item,item,...))	返回指定的項目的顛倒順序。 例子：reverse(("ab", "cd", "ef")) 結果：("ef", "cd", "ab") 例子：reverse(("ab")) 結果：("ab")
fn:subsequence((item,item,...),start,len)	返回 start 參數指定的位置返回項目序列，序列的長度由 len 參數指定。第一個項目的位置是 1。 例子：subsequence(($item1, $item2, $item3,...), 3) 結果：($item3, ...) 例子：subsequence(($item1, $item2, $item3, ...), 2, 2) 結果：($item2, $item3)
fn:unordered((item,item,...))	依據實現決定的順序來返回項目。

測試序列容量的函數

名稱	說明
fn:zero-or-one(item,item,...)	若是參數包含零個或一個項目，則返回參數，不然生成錯誤。
fn:one-or-more(item,item,...)	若是參數包含一個或多個項目，則返回參數，不然生成錯誤。
fn:exactly-one(item,item,...)	若是參數包含一個項目，則返回參數，不然生成錯誤。

Equals, Union, Intersection and Except

名稱	說明
fn:deep-equal(param1,param2,collation)	若是 param1 和 param2 與彼此相等（deep-equal），則返回 true，不然返回 false。

合計函數

名稱	說明
fn:count((item,item,...))	返回節點的數量。
fn:avg((arg,arg,...))	返回參數值的平均數。例子：avg((1,2,3)) 結果：2
fn:max((arg,arg,...))	返回大於其它參數的參數。例子：max((1,2,3)) 結果：3 例子：max(('a', 'k')) 結果：'k'
fn:min((arg,arg,...))	返回小於其它參數的參數。例子：min((1,2,3)) 結果：1 例子：min(('a', 'k')) 結果：'a'
fn:sum(arg,arg,...)	返回指定節點集中每一個節點的數值的總和。

生成序列的函數

名稱	說明
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() 函數返回文檔節點，則返回 true，不然返回 false。
fn:collection() fn:collection(string)

上下文函數

名稱	說明
fn:position()	返回當前正在被處理的節點的 index 位置。 例子：//book[position()<=3] 結果：選擇前三個 book 元素
fn:last()	返回在被處理的節點列表中的項目數目。 例子：//book[last()] 結果：選擇最後一個 book 元素
fn:current-dateTime()	返回當前的 dateTime（帶有時區）。
fn:current-date()	返回當前的日期（帶有時區）。
fn:current-time()	返回當前的時間（帶有時區）。
fn:implicit-timezone()	返回隱式時區的值。
fn:default-collation()	返回默認對照的值。
fn:static-base-uri()	返回 base-uri 的值。