Funkcje XSLT, XPath oraz XQuery

• 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ść parametru. Parametr może być wartością logiczną, ciągami znaków lub zbiorem węzłów.

Przykład: number('100')

Wynik: 100

Zwróć wartość bezwzględną argumentu.

Przykład: abs(3.14)

Wynik: 3.14

Przykład: abs(-3.14)

Wynik: 3.14

Zwróć najmniejszą liczbę całkowitą większą niż parametr num.

Przykład: ceiling(3.14)

Wynik: 4

Zwróć największą liczbę całkowitą nie większą niż parametr num.

Przykład: floor(3.14)

Wynik: 3

Zaokrąglij 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

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

Przykład: string(314)

Wynik: "314"

Zgodnie z sekwencją kodów punktowanych zwróć string.

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

Wynik: 'Thérèse'

Zgodnie ze stringiem zwróć sekwencję kodów punktowanych.

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ówny comp2, zwróć 0. Jeśli comp1 jest większy niż comp2, zwróć 1. (Zgodnie z używanymi zasadami porównania).

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

Wynik: 0

Zwraca sklejone ciągi znaków.

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

Wynik: 'XPath is 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 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 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 tekstowej 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ślonego 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 wielkie 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"

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

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

Wynik: true

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

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

Wynik: true

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

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

Wynik: false

Zwraca podstring przed pojawieniem się string2 w string1.

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

Wynik: '12'

Zwraca podciąg znaków znajdujący się 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 replace parametrem 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 parametr do wartości logicznej za pomocą funkcji boolean().

Zwraca true, jeśli wartość logiczna jest fałszywa, w przeciwnym razie zwraca true.

Przykład: not(true())

Wynik: false

Zwraca wartość logiczną prawdziwą.

Przykład: true()

Wynik: true

Zwraca wartość logiczną fałszywą.

Przykład: false()

Wynik: false

Zwraca całkowitą wartość lat lokalnej wartości parametru.

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

Wynik: 2005

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

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

Wynik: 01

Zwraca całkowitą wartość dni lokalnej wartości parametru.

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

Wynik: 10

Zwraca całkowitą wartość godzin lokalnej wartości parametru.

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

Wynik: 12

Zwraca całkowitą wartość minut lokalnej wartości parametru.

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

Wynik: 30

Zwraca dziesiętną wartość sekundową lokalnej wartości parametru.

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

Wynik: 0

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

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

Jeśli parametr timezone jest pusty, zwracany jest dateTime bez strefy czasowej.

W przeciwnym razie zwracany jest dateTime z strefą czasową.

Jeśli parametr timezone jest pusty, zwracany jest data bez strefy czasowej.

W przeciwnym razie zwracany jest data z strefą czasową.

Jeśli parametr timezone jest pusty, zwracany jest czas bez strefy czasowej.

W przeciwnym razie zwraca czas z datą i czasem.

• 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 określonego języka.

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

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

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

Zwraca pozycję elementu w sekwencji równego 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")

Zwraca true, jeśli wartość parametru jest pustą sekwencją, 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, gdzie wartość parametru inserts jest wstawiona w pozycji określonej przez parametr pos.

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 elementów.

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

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

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

Wynik: ("ab")

Zwraca sekwencję elementów zaczynającą się od pozycji określonej przez parametr start, długość sekwencji określona przez parametr len.

Pozycja pierwszego elementu to 1.

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

Wynik: ($item3, ...)

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

Wynik: ($item2, $item3)

Zwraca średnią wartość parametrów.

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

Wynik: 2

Zwraca parametr większy niż inne parametry.

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

Wynik: 3

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

Wynik: 'k'

Zwraca parametr mniejszy niż inne parametry.

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

Wynik: 1

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

Wynik: 'a'

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

Zwraca pozycję bieżącego węzła przetwarzanego.

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

Wynik: wybór pierwszych trzech elementów book

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

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

Wynik: wybór ostatniego elementu book