Funkcje XPath, XQuery oraz XSLT

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

• fn:error()
• fn:error(error)
• fn:error(error,description)
• fn:error(error,description,error-object)

Przykład: error(fn:QName('http://example.com/test', 'err:toohigh'), 'Błąd: Cena jest zbyt wysoka')

Wynik: Zwraca do zewnętrznego środowiska przetwarzania http://example.com/test#toohigh oraz ciąg znaków "Błąd: Cena jest zbyt wysoka".

Zwraca wartość liczbową parametru. Parametr może być wartością logiczną, ciągami znaków lub zbiorem węzłów.

Przykład: number('100')

Wynik: 100

Zwraca wartość bezwzględną parametru.

Przykład: abs(3.14)

Wynik: 3.14

Przykład: abs(-3.14)

Wynik: 3.14

Zwraca najmniejszą liczbę całkowitą większą od parametru num.

Przykład: ceiling(3.14)

Wynik: 4

Zwraca największą liczbę całkowitą nie większą niż parametr num.

Przykład: floor(3.14)

Wynik: 3

Zaokrągla parametr num do najbliższej liczby całkowitej.

Przykład: round(3.14)

Wynik: 3

Przykład: round-half-to-even(0.5)

Wynik: 0

Przykład: round-half-to-even(1.5)

Wynik: 2

Przykład: round-half-to-even(2.5)

Wynik: 2

Zwraca wartość tekstową argumentu. Argumentem może być liczba, wartość logiczna lub zbiór węzłów.

Przykład: string(314)

Wynik: "314"

Zwraca ciąg znaków z sekwencji kodów punktowanych.

Przykład: codepoints-to-string(84, 104, 233, 114, 232, 115, 101)

Wynik: 'Thérèse'

Zwraca sekwencję kodów punktowanych z ciągu znaków.

Przykład: string-to-codepoints("Thérèse")

Wynik: 84, 104, 233, 114, 232, 115, 101

• fn:compare(comp1, comp2)
• fn:compare(comp1, comp2, collation)

Jeśli comp1 jest mniejszy niż comp2, zwróć -1. Jeśli comp1 jest równe comp2, zwróć 0. Jeśli comp1 jest większy niż comp2, zwróć 1. (Zgodnie z używaną zasadą porównania).

Przykład: compare('ghi', 'ghi')

Wynik: 0

Zwraca łączenie ciągów znaków.

Przykład: concat('XPath ', 'is ', 'FUN!')

Wynik: 'XPath jest FUN!"

Używa parametru sep jako separatora, aby zwrócić sklejony ciąg znaków parametru string.}

Przykład: string-join(('We', 'are', 'having', 'fun!'), ' ')

Wynik: ' We are having fun! '

Przykład: string-join(('We', 'are', 'having', 'fun!'))

Wynik: 'Wearehavingfun!'

Przykład: string-join((), 'sep')

Wynik: ''

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

Zwraca podciąg znaków o określonej długości zaczynający się od pozycji start. Pierwszy znak ma indeks 1. Jeśli pominięto parametr len, zwraca podciąg znaków od pozycji start do końca ciągu.

Przykład: substring('Beatles',1,4)

Wynik: 'Beat'

Przykład: substring('Beatles',2)

Wynik: 'eatles'

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

Zwraca długość określonego ciągu znaków. Jeśli nie podano parametru string, zwraca długość wartości string bieżącego węzła.

Przykład: string-length('Beatles')

Wynik: 7

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

Usuwa białe znaki z początku i końca określonej ciągu znaków i zastępuje wszystkie sekwencje białych znaków jednym, zwracając wynik. Jeśli nie podano parametru string, przetwarza bieżący węzeł.

Przykład: normalize-space(' The　　　XML ')

Wynik: 'The XML'

Konwertuje parametr string na duże litery.

Przykład: upper-case('The XML')

Wynik: 'THE XML'

Konwertuje parametr string na małe litery.

Przykład: lower-case('The XML')

Wynik: 'the xml'

Zamienia string2 w string1 na string3.

Przykład: translate('12:30','30','45')

Wynik: '12:45'

Przykład: translate('12:30','03','54')

Wynik: '12:45'

Przykład: translate('12:30','0123','abcd')

Wynik: 'bc:da'

Przykład: escape-uri("http://example.com/test#car", true())

Wynik: "http%3A%2F%2Fexample.com%2Ftest#car"

Przykład: escape-uri("http://example.com/test#car", false())

Wynik: "http://example.com/test#car"

Przykład: escape-uri ("http://example.com/~bébé", false())

Wynik: "http://example.com/~b%C3%A9b%C3%A9"

Zwraca true, jeśli string1 zawiera string2, w przeciwnym razie zwraca false.

Przykład: contains('XML','XM')

Wynik: true

Zwraca true, jeśli string1 zaczyna się string2, w przeciwnym razie zwraca false.

Przykład: starts-with('XML','X')

Wynik: true

Zwraca true, jeśli string1 kończy się string2, w przeciwnym razie zwraca false.

Przykład: ends-with('XML','X')

Wynik: false

Zwraca podciąg znaków, który występuje przed string2 w string1.

Przykład: substring-before('12/10','/')

Wynik: '12'

Zwraca podciąg znaków, który występuje po string2 w string1.

Przykład: substring-after('12/10','/')

Wynik: '10'

Zwraca true, jeśli parametr string pasuje do określonego wzorca, w przeciwnym razie zwraca false.

Przykład: matches("Merano", "ran")

Wynik: true

Zastępuje określony wzorzec wartością z parametru replace i zwraca wynik.

Przykład: replace("Bella Italia", "l", "*")

Wynik: 'Be**a Ita*ia'

Przykład: replace("Bella Italia", "l", "")

Wynik: 'Bea Itaia'

Przykład: tokenize("XPath is fun", "\s+")

Wynik: ("XPath", "is", "fun")

Najpierw przywraca wartość parametru do wartości logicznej za pomocą funkcji boolean(). Jeśli wartość logiczna wynosi false, zwraca true, w przeciwnym razie zwraca true.

Przykład: not(true())

Wynik: false

Zwraca wartość logiczną true.

Przykład: true()

Wynik: true

Zwraca wartość logiczną false.

Przykład: false()

Wynik: false

Zwraca lokalną wartość parametru jako całkowitą liczbę lat.

Przykład: year-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Wynik: 2005

Zwraca lokalną wartość parametru jako całkowitą liczbę miesięcy.

Przykład: month-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Wynik: 01

Zwraca lokalną wartość parametru jako całkowitą liczbę dni.

Przykład: day-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Wynik: 10

Zwraca lokalną wartość parametru jako całkowitą liczbę godzin.

Przykład: hours-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Wynik: 12

Zwraca lokalną wartość parametru jako całkowitą liczbę minut.

Przykład: minutes-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Wynik: 30

Zwraca lokalną wartość parametru jako dziesiętną liczbę sekund.

Przykład: seconds-from-dateTime(xs:dateTime("2005-01-10T12:30:00-04:10"))

Wynik: 0

Zwraca lokalną wartość parametru jako całkowity liczba lat.

Przykład: year-from-date(xs:date("2005-04-23"))

Wynik: 2005

Zwraca całkowitą liczbę miesięcy w wartości lokalnej parametru.

Przykład: month-from-date(xs:date("2005-04-23"))

Wynik: 4

Zwraca całkowitą liczbę dni w wartości lokalnej parametru.

Przykład: day-from-date(xs:date("2005-04-23"))

Wynik: 23

Zwraca całkowitą liczbę godzin w wartości lokalnej parametru.

Przykład: hours-from-time(xs:time("10:22:00"))

Wynik: 10

Zwraca całkowitą liczbę minut w wartości lokalnej parametru.

Przykład: minutes-from-time(xs:time("10:22:00"))

Wynik: 22

Zwraca całkowitą liczbę sekund w wartości lokalnej parametru.

Przykład: seconds-from-time(xs:time("10:22:00"))

Wynik: 0

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

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

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

Zwraca true, jeśli język bieżącego węzła pasuje do wskazanego języka.

Przykład: Lang("en") jest prawdziwy dla <p xml:lang="en">...</p>

Przykład: Lang("de") jest fałszywy dla <p xml:lang="en">...</p>

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

Zwraca pozycje elementów sekwencji, które są równe parametrowi searchitem.

Przykład: index-of ((15, 40, 25, 40, 10), 40)

Wynik: (2, 4)

Przykład: index-of (("a", "dog", "and", "a", "duck"), "a")

Wynik (1, 4)

Przykład: index-of ((15, 40, 25, 40, 10), 18)

Wynik: ()

Zwraca nową sekwencję zbudowaną z parametru item, jednocześnie usuwając element指定 position parametru.

Przykład: remove(("ab", "cd", "ef"), 0)

Wynik: ("ab", "cd", "ef")

Przykład: remove(("ab", "cd", "ef"), 1)

Wynik: ("cd", "ef")

Przykład: remove(("ab", "cd", "ef"), 4)

Wynik: ("ab", "cd", "ef")

Jeśli wartość parametru jest pustym sekwencją, zwraca true, w przeciwnym razie zwraca false.

Przykład: empty(remove(("ab", "cd"), 1))

Wynik: false

Zwraca true, jeśli wartość parametru nie jest pustą sekwencją, w przeciwnym razie zwraca false.

Przykład: exists(remove(("ab"), 1))

Wynik: false

Zwraca unikalne wartości.

Przykład: distinct-values((1, 2, 3, 1, 2))

Wynik: (1, 2, 3)

Zwraca nową sekwencję zbudowaną z parametru item - jednocześnie w pozycji określonej przez parametr pos wstawia wartość z parametru inserts.

Przykład: insert-before(("ab", "cd"), 0, "gh")

Wynik: ("gh", "ab", "cd")

Przykład: insert-before(("ab", "cd"), 1, "gh")

Wynik: ("gh", "ab", "cd")

Przykład: insert-before(("ab", "cd"), 2, "gh")

Wynik: ("ab", "gh", "cd")

Przykład: insert-before(("ab", "cd"), 5, "gh")

Wynik: ("ab", "cd", "gh")

Zwraca odwróconą kolejność określonych projektów.

Przykład: reverse(("ab", "cd", "ef"))

Wynik: ("ef", "cd", "ab")

Przykład: reverse(("ab"))

Wynik: ("ab")

Zwraca sekwencję projektów指定位置由 start parametr指定，序列的长度由 len parametr指定。第一个项目的位置是 1。

Przykład: subsequence(($item1, $item2, $item3,...), 3)

Wynik: ($item3, ...)

Przykład: subsequence(($item1, $item2, $item3, ...), 2, 2)

Wynik: ($item2, $item3)

Zwraca średnią wartości argumentów.

Przykład: avg((1,2,3))

Wynik: 2

Zwraca argument większy niż inne parametry.

Przykład: max((1,2,3))

Wynik: 3

Przykład: max(('a', 'k'))

Wynik: 'k'

Zwraca argument mniejszy niż inne parametry.

Przykład: min((1,2,3))

Wynik: 1

Przykład: min(('a', 'k'))

Wynik: 'a'

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

Zwróć pozycję bieżącego węzła przetwarzanego.

Przykład: //book[position()<=3]

Wynik: wybierz pierwsze trzy elementy book

Zwróć liczbę elementów w liście węzłów przetwarzanych.

Przykład: //book[last()]

Wynik: wybierz ostatni element book