Podręcznik referencyjny XML

• Element (maks. jeden)
• ProcessingInstruction
• Komentarz
• DocumentType

• ProcessingInstruction
• Komentarz
• Text
• CDATASection
• EntityReference

• ProcessingInstruction
• Komentarz
• Text
• CDATASection
• EntityReference

• Text
• Komentarz
• ProcessingInstruction
• CDATASection
• EntityReference

• Text
• EntityReference

• ProcessingInstruction
• Komentarz
• Text
• CDATASection
• EntityReference

Zwraca obiekt powiązany z kluczem na węźle.

Najpierw należy ustawić obiekt na tym węźle, używając setUserData z tym samym kluczem.

Metoda normalize() usuwa puste węzły tekstowe i łączy sąsiednie węzły tekstowe.

Normalizuje wszystkie węzły tekstowe pod elementem (w tym atrybuty), gdzie tylko struktura (np. elementy, komentarze, instrukcje przetwarzania, sekcje CDATA i odwołania do encji) oddziela węzły tekstowe.

To znaczy, że nie istnieją sąsiednie węzły tekstowe ani puste węzły tekstowe.

Jeśli wartość atrybutu została ustawiona w dokumencie, zwróć true;

Jeśli wartość atrybutu jest wartością domyślną w DTD/Schema, zwróć false.

Określ typ żądania, URL, czy żądanie powinno być przetwarzane asynchronicznie oraz inne opcjonalne atrybuty żądania.

• method: typ żądania: GET lub POST
• url: lokalizacja pliku na serwerze
• async: true (asynchroniczne) lub false (synchroniczne)

Wysyłaj żądanie do serwera.

string: używane tylko w żądaniach POST

Zapisuje stan XMLHttpRequest. Zmiany od 0 do 4:

• 0: żądanie nie zainicjalizowane
• 1: połączenie z serwerem ustanowione
• 2: żądanie otrzymane
• 3: przetwarzanie żądania
• 4: żądanie zakończone, odpowiedź gotowa

• 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ść numeryczną parametru. Parametr może być wartością logiczną, ciągami znaków lub kolekcją 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: dachowanie(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 na podstawie sekwencji kodów punktowych.

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

Wynik: 'Thérèse'

Zwraca sekwencję kodów punktowych na podstawie 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ą regułą 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!�c

Używa parametru sep jako separatora, aby zwrócić sklejony ciąg znaków z 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ś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 pojawia się przed string2 w string1.

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

Wynik: '12'

Zwraca podciąg znaków, który pojawia 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

Zamienia określony wzorzec na wartość 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 parametr do wartości logicznej za pomocą funkcji boolean().

Jeśli wartość logiczna jest 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 liczbę całkowitą reprezentującą rok w wartości lokalnej parametru.

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

Wynik: 2005

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

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

Wynik: 01

Zwraca liczbę całkowitą reprezentującą dzień w wartości lokalnej parametru.

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

Wynik: 10

Zwraca liczbę całkowitą reprezentującą godziny w wartości lokalnej parametru.

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

Wynik: 12

Zwraca liczbę całkowitą reprezentującą minuty w wartości lokalnej parametru.

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

Wynik: 30

Zwraca dziesiętną liczbę sekund w wartości lokalnej parametru.

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

Wynik: 0

Zwraca liczbę całkowitą reprezentującą rok w wartości lokalnej parametru.

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

Wynik: 2005

Zwróć całkowitą liczbę miesięcy w wartości lokalnej parametru.

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

Wynik: 4

Zwróć całkowitą liczbę dni w wartości lokalnej parametru.

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

Wynik: 23

Zwróć całkowitą liczbę godzin w wartości lokalnej parametru.

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

Wynik: 10

Zwróć całkowitą liczbę minut w wartości lokalnej parametru.

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

Wynik: 22

Zwróć 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, zwróć dateTime bez strefy czasowej.

W przeciwnym razie zwróć dateTime z czasem strefy czasowej.

Jeśli parametr timezone jest pusty, zwróć date bez strefy czasowej.

W przeciwnym razie zwróć date z czasem strefy czasowej.

Jeśli parametr timezone jest pusty, zwróć czas bez strefy czasowej.

W przeciwnym razie zwróć czas z czasem strefy czasowej.

• 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 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 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 o podanej pozycji.

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ę, która jest konstruowana z parametru item, jednocześnie wstawiając wartość inserts 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 projektów.

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

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

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

Wynik: ("ab")

Zwraca sekwencję projektów指定位置返回项目序列，序列的长度由 len 参数指定。

Pozycja pierwszego projektu 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ści 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 index pozycji bieżącego przetwarzanego węzła.

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

Wynik: wybierz pierwsze trzy elementy book

返回在被处理的节点列表中的项目数目。

例子：//book[last()]

结果：选择最后一个 book 元素