XSLT、XPath および XQuery 関数

• 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

string1 に string2 が出现する前にあるサブストリングを返します。

例：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") は true です。 <p xml:lang="en">...</p>

例：Lang("de") は false です。 <p xml:lang="en">...</p>

• fn:root()
• fn:root(node)

検索項目がシーケンスの項目に等しい位置を返します。

例：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 エレメントを選択