XPath, XQuery und XSLT-Funktionen

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

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

Beispiel: error(fn:QName('http://example.com/test', 'err:toohigh'), 'Error: Price is too high')

Ergebnis: Gibt an den externen Verarbeitungsumgebung http://example.com/test#toohigh zurück sowie die Zeichenkette "Error: Price is too high".

Gibt den numerischen Wert des Arguments zurück. Das Argument kann ein Boolescher Wert, ein String oder eine Knotensequenz sein.

Beispiel: number('100')

Ergebnis: 100

Gibt den Absolutwert des Arguments zurück.

Beispiel: abs(3.14)

Ergebnis: 3.14

Beispiel: abs(-3.14)

Ergebnis: 3.14

Gibt die kleinste Ganzzahl zurück, die größer als das Argument num ist.

Beispiel: ceiling(3.14)

Ergebnis: 4

Rückgabe der größten Ganzzahl, die nicht größer als das Argument num ist.

Beispiel: floor(3.14)

Ergebnis: 3

Rundet den Parameter num auf die nächstgelegene Ganzzahl.

Beispiel: round(3.14)

Ergebnis: 3

Beispiel: round-half-to-even(0.5)

Ergebnis: 0

Beispiel: round-half-to-even(1.5)

Ergebnis: 2

Beispiel: round-half-to-even(2.5)

Ergebnis: 2

Rückgabe des Zeichenfolgenrechtes des Arguments. Das Argument kann eine Zahl, ein logisches Wert oder ein Knotenset sein.

Beispiel: string(314)

Ergebnis: "314"

Rückgabe der Zeichenfolge basierend auf der Zeichensatzpunktkette.

Beispiel: codepoints-to-string(84, 104, 233, 114, 232, 115, 101)

Ergebnis: 'Thérèse'

Rückgabe der Zeichensatzpunktsequenz basierend auf der Zeichenfolge.

Beispiel: string-to-codepoints("Thérèse")

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

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

Wenn comp1 kleiner als comp2 ist, wird -1 zurückgegeben. Wenn comp1 gleich comp2 ist, wird 0 zurückgegeben. Wenn comp1 größer als comp2 ist, wird 1 zurückgegeben. (Abhängig vom verwendeten Vergleichsregeln).

Beispiel: compare('ghi', 'ghi')

Ergebnis: 0

Rückgabe der Verkettung von Zeichenfolgen.

Beispiel: concat('XPath ','ist ','FUN!')

Ergebnis: 'XPath ist FUN!'

Verwendet den Parameter sep als Trennzeichen, um die durch den String-Parameter verbundenen Zeichenfolgen zurückzugeben.

Beispiel: string-join(('We', 'are', 'having', 'fun!'), ' ')

Ergebnis: ' We are having fun! '

Beispiel: string-join(('We', 'are', 'having', 'fun!'))

Ergebnis: 'Wearehavingfun!'

Beispiel: string-join((), 'sep')

Ergebnis: ''

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

Gibt einen vom start-Position beginnenden und die angegebene Länge lange Teilstring zurück. Der Index des ersten Zeichens ist 1. Wenn der Parameter len weggelassen wird, wird der Teilstring von der Position start bis zum Ende der Zeichenkette zurückgegeben.

Beispiel: substring('Beatles',1,4)

Ergebnis: 'Beat'

Beispiel: substring('Beatles',2)

Ergebnis: 'eatles'

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

Gibt die Länge des angegebenen Strings zurück. Wenn kein string-Parameter angegeben ist, wird die Länge des String-Werts des aktuellen Knotens zurückgegeben.

Beispiel: string-length('Beatles')

Ergebnis: 7

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

Entfernt den angegebenen String am Anfang und Ende und ersetzt alle internen Leerzeichenfolgen durch ein Leerzeichen, und gibt das Ergebnis zurück. Wenn kein string-Parameter angegeben ist, wird der aktuelle Knoten verarbeitet.

Beispiel: normalize-space(' The　　　XML ')

Ergebnis: 'The XML'

Konvertiert den Parameter string in Großbuchstaben.

Beispiel: upper-case('The XML')

Ergebnis: 'THE XML'

Konvertiert den Parameter string in Kleinbuchstaben.

Beispiel: lower-case('The XML')

Ergebnis: 'the xml'

Ersetze string2 in string1 durch string3.

Beispiel: translate('12:30','30','45')

Ergebnis: '12:45'

Beispiel: translate('12:30','03','54')

Ergebnis: '12:45'

Beispiel: translate('12:30','0123','abcd')

Ergebnis: 'bc:da'

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

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

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

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

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

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

Gibt true zurück, wenn string1 string2 enthält, sonst false.

Beispiel: contains('XML','XM')

Ergebnis: true

Gibt true zurück, wenn string1 mit string2 beginnt, sonst false.

Beispiel: starts-with('XML','X')

Ergebnis: true

Gibt true zurück, wenn string1 mit string2 endet, sonst false.

Beispiel: ends-with('XML','X')

Ergebnis: false

Rückgabe des Untertextes, der vor dem Auftreten von string2 in string1 folgt.

Beispiel: substring-before('12/10','/')

Ergebnis: '12'

Rückgabe des Untertextes, der nach dem Auftreten von string2 in string1 folgt.

Beispiel: substring-after('12/10','/')

Ergebnis: '10'

Wenn der Wert des Strings mit dem angegebenen Muster übereinstimmt, wird true zurückgegeben, andernfalls wird false zurückgegeben.

Beispiel: matches("Merano", "ran")

Ergebnis: true

Ersetzen des angegebenen Musters durch den replace-Parameter und Rückgabe des Ergebnisses.

Beispiel: replace("Bella Italia", "l", "*")

Ergebnis: 'Be**a Ita*ia'

Beispiel: replace("Bella Italia", "l", "")

Ergebnis: 'Bea Itaia'

Beispiel: tokenize("XPath is fun", "\s+")

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

Zunächst wird der Parameter durch die Funktion boolean() in einen booleschen Wert umgewandelt. Wenn der boolesche Wert false ist, wird true zurückgegeben, andernfalls wird true zurückgegeben.

Beispiel: not(true())

Ergebnis: false

Rückgabewert des booleschen Wertes true.

Beispiel: true()

Ergebnis: true

Rückgabewert des booleschen Wertes false.

Beispiel: false()

Ergebnis: false

Gibt die lokale Wertangabe des Parameters als Integer des Jahres zurück.

Beispiel: year-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Ergebnis: 2005

Gibt die lokale Wertangabe des Parameters als Integer des Monats zurück.

Beispiel: month-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Ergebnis: 01

Gibt die lokale Wertangabe des Parameters als Integer des Tages zurück.

Beispiel: day-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Ergebnis: 10

Gibt die lokale Wertangabe des Parameters als Integer der Stunden zurück.

Beispiel: hours-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Ergebnis: 12

Gibt die lokale Wertangabe des Parameters als Integer der Minuten zurück.

Beispiel: minutes-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Ergebnis: 30

Gibt die lokale Wertangabe des Parameters als Dezimalzahl der Sekunden zurück.

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

Ergebnis: 0

Gibt die lokale Wertangabe des Parameters als Integer des Jahres zurück.

Beispiel: year-from-date(xs:date("2005-04-23"))

Ergebnis: 2005

Gibt die Ganzzahl des Monats des lokalen Wertes des Parameters zurück.

Beispiel: month-from-date(xs:date("2005-04-23"))

Ergebnis: 4

Gibt die Ganzzahl des Tages des lokalen Wertes des Parameters zurück.

Beispiel: day-from-date(xs:date("2005-04-23"))

Ergebnis: 23

Gibt die Ganzzahl des Stunden-Teils des lokalen Wertes des Parameters zurück.

Beispiel: hours-from-time(xs:time("10:22:00"))

Ergebnis: 10

Gibt die Ganzzahl des Minuten-Teils des lokalen Wertes des Parameters zurück.

Beispiel: minutes-from-time(xs:time("10:22:00"))

Ergebnis: 22

Gibt die Ganzzahl des Sekunden-Teils des lokalen Wertes des Parameters zurück.

Beispiel: seconds-from-time(xs:time("10:22:00"))

Ergebnis: 0

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

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

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

Gibt true zurück, wenn die Sprache des aktuellen Knotens mit der angegebenen Sprache übereinstimmt.

Beispiel: Lang("en") ist true für <p xml:lang="en">...</p>

Beispiel: Lang("de") ist false für <p xml:lang="en">...</p>

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

Gibt die Positionen zurück, an denen das Element in der Projektsfolge gleich searchitem ist.

Beispiel: index-of ((15, 40, 25, 40, 10), 40)

Ergebnis: (2, 4)

Beispiel: index-of (("a", "dog", "and", "a", "duck"), "a")

Ergebnis (1, 4)

Beispiel: index-of ((15, 40, 25, 40, 10), 18)

Ergebnis: ()

Gibt eine neue Sequenz zurück, die durch den item-Parameter konstruiert wird - und das Element an der angegebenen position-Position entfernt.

Beispiel: remove(("ab", "cd", "ef"), 0)

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

Beispiel: remove(("ab", "cd", "ef"), 1)

Ergebnis: ("cd", "ef")

Beispiel: remove(("ab", "cd", "ef"), 4)

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

Wenn der Parameterwert eine leere Sequenz ist, wird true zurückgegeben, sonst false.

Beispiel: empty(remove(("ab", "cd"), 1))

Ergebnis: false

Wird der Wert des Parameters nicht eine leere Sequenz sein, wird true zurückgegeben,否则返回 false.

Beispiel: exists(remove(("ab"), 1))

Ergebnis: false

Rückgabe einzigartiger Werte.

Beispiel: distinct-values((1, 2, 3, 1, 2))

Ergebnis: (1, 2, 3)

Rückgabe einer neuen Sequenz, die durch den item-Parameter konstruiert wird - gleichzeitig wird der Wert der inserts-Parameter an der durch den pos-Parameter angegebenen Position eingefügt.

Beispiel: insert-before(("ab", "cd"), 0, "gh")

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

Beispiel: insert-before(("ab", "cd"), 1, "gh")

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

Beispiel: insert-before(("ab", "cd"), 2, "gh")

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

Beispiel: insert-before(("ab", "cd"), 5, "gh")

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

Rückgabe der umgekehrten Reihenfolge der angegebenen Elemente.

Beispiel: reverse(("ab", "cd", "ef"))

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

Beispiel: reverse(("ab"))

Ergebnis: ("ab")

Rückgabe der Elementfolgen an der durch den start-Parameter angegebenen Position, die Länge der Sequenz wird durch den len-Parameter angegeben. Die Position des ersten Elements ist 1.

Beispiel: subsequence(($item1, $item2, $item3,...), 3)

Ergebnis: ($item3, ...)

Beispiel: subsequence(($item1, $item2, $item3, ...), 2, 2)

Ergebnis: ($item2, $item3)

Gibt den Durchschnitt der Werte der Parameter zurück.

Beispiel: avg((1,2,3))

Ergebnis: 2

Gibt den Parameter zurück, der größer als die anderen Parameter ist.

Beispiel: max((1,2,3))

Ergebnis: 3

Beispiel: max(('a', 'k'))

Ergebnis: 'k'

Gibt den Parameter zurück, der kleiner als die anderen Parameter ist.

Beispiel: min((1,2,3))

Ergebnis: 1

Beispiel: min(('a', 'k'))

Ergebnis: 'a'

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

Rückgabe der indexartigen Position des aktuellen Knotens, der bearbeitet wird.

Beispiel: //book[position()<=3]

Ergebnis: Auswahl der ersten drei book-Elemente

Rückgabe der Anzahl der Elemente in der Liste der verarbeiteten Knoten.

Beispiel: //book[last()]

Ergebnis: Auswahl des letzten book-Elements