XPath、XQuery および XSLT 関数

• 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

返却する数値の最小の整数を返します。

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

string1 中 string2 出现之前的子字符串を返します。

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

結果：'12'

string1 中 string2 出现之后的子字符串を返します。

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

返却パラメータのローカル値の秒部分の10進数。

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

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

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

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

現在のノードの言語が指定された言語に一致する場合、true を返します。

例：Lang("en") は、以下のために true です <p xml:lang="en">...</p>

例：Lang("de") は、以下のために false です <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")

結果：(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]

結果：最初の 3 つの book 要素を選択

処理されているノードリスト内の要素数を返します。

例：//book[last()]

結果：最後の book 要素を選択