CodeW3C.com-Taschenbuch

• 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"。

返回参数的数值。参数可以是布尔值、字符串或节点集。

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 das kleinste Ganze zurück, das größer als der Parameter num ist.

Beispiel: ceiling(3.14)

Ergebnis: 4

Gibt das größte Ganze zurück, das nicht größer als der Parameter num ist.

Beispiel: floor(3.14)

Ergebnis: 3

Rundet den Parameter num auf den nächstgelegenen Ganzen an.

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

Gibt den Stringwert des Arguments zurück. Das Argument kann eine Zahl, ein logisches Wert oder ein Knotenset sein.

Beispiel: string(314)

Ergebnis: "314"

Laut Zeichensatzpunktreihe wird eine Zeichenfolge zurückgegeben.

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

Ergebnis: 'Thérèse'

Laut Zeichenfolge wird eine Zeichensatzpunktreihe zurückgegeben.

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 (entsprechend den verwendeten Vergleichsregeln).

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

Ergebnis: 0

Gibt die Verknüpfung von Zeichenketten zurück.

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

Ergebnis: 'XPath is FUN!'

Verwendet den sep-Parameter als Trennzeichen, um eine durch die string-Parameter verknüpfte Zeichenkette 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 eine angegebene Länge betreffenden Teilstring zurück. Der Index des ersten Zeichens ist 1. Wenn der Parameter len weggelassen wird, wird ein Teilstring von der Position start bis zum Ende des Strings 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 eines angegebenen Strings zurück. Ohne string-Parameter 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 die Leerzeichen am Anfang und Ende eines angegebenen Strings und ersetzt alle internen Leerzeichenfolgen durch ein Leerzeichen, und gibt das Ergebnis zurück. Ohne string-Parameter wird der aktuelle Knoten bearbeitet.

Beispiel: normalize-space(' The　　　XML ')

Ergebnis: 'The XML'

Konvertiert den String-Parameter in Großbuchstaben.

Beispiel: upper-case('The XML')

Ergebnis: 'THE XML'

Konvertiere den string-Parameter 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 Unterstrings, der vor dem Erscheinen von string2 in string1 liegt.

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

Ergebnis: '12'

Gibt den Teil der Zeichenkette string2 zurück, der nach dem Auftreten von string1 folgt.

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

Ergebnis: '10'

Gibt true zurück, wenn der string-Parameter mit dem angegebenen Muster übereinstimmt, sonst wird false zurückgegeben.

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

Ergebnis: true

Ersetzt das angegebene Muster durch den replace-Parameter und gibt das Ergebnis zurück.

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 boolean() -Funktion in einen booleschen Wert umgewandelt.

Gibt true zurück, wenn der boolesche Wert false ist, sonst wird true zurückgegeben.

Beispiel: not(true())

Ergebnis: false

Gibt den booleschen Wert true zurück.

Beispiel: true()

Ergebnis: true

Gibt den booleschen Wert false zurück.

Beispiel: false()

Ergebnis: false

Rückgabeparameter: Ganzzahl des lokalen Wertes des Jahres.

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

Ergebnis: 2005

Rückgabeparameter: Ganzzahl des lokalen Wertes des Monats.

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

Ergebnis: 01

Rückgabeparameter: Ganzzahl des lokalen Wertes des Tages.

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

Ergebnis: 10

Rückgabeparameter: Ganzzahl des lokalen Wertes der Stunden.

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

Ergebnis: 12

Rückgabeparameter: Ganzzahl des lokalen Wertes der Minuten.

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

Ergebnis: 30

Rückgabeparameter: Dezimalzahl des lokalen Wertes der Sekunden.

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

Ergebnis: 0

Gibt die ganze Zahl zurück, die im lokalen Wert des Parameters das Jahr darstellt.

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

Ergebnis: 2005

Gibt die ganze Zahl zurück, die im lokalen Wert des Parameters den Monat darstellt.

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

Ergebnis: 4

Gibt die ganze Zahl zurück, die im lokalen Wert des Parameters den Tag darstellt.

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

Ergebnis: 23

Gibt die ganze Zahl zurück, die im lokalen Wert des Parameters die Stundenpart darstellt.

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

Ergebnis: 10

Gibt die ganze Zahl zurück, die im lokalen Wert des Parameters die Minutenpart darstellt.

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

Ergebnis: 22

Gibt die ganze Zahl zurück, die im lokalen Wert des Parameters die Sekundenpart darstellt.

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

Ergebnis: 0

Wenn der Parameter timezone leer ist, wird das dateTime ohne Zeitzone zurückgegeben.

Sonst wird das dateTime mit der Zeitzone zurückgegeben.

Wenn der Parameter timezone leer ist, wird das Datum ohne Zeitzone zurückgegeben.

Sonst wird das Datum mit der Zeitzone zurückgegeben.

Wenn der Parameter timezone leer ist, wird die Zeit ohne Zeitzone zurückgegeben.

Ansonsten wird die Zeit mit dem Zeitzeichen zurückgegeben.

• 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 Position zurück, an der das searchitem-Element in der Sequenz der Elemente positioniert 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")

Gibt true zurück, wenn der Parameterwert eine leere Sequenz ist, sonst false.

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

Ergebnis: false

Gibt true zurück, wenn der Parameterwert keine leere Sequenz ist, sonst false.

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

Ergebnis: false

Gibt die einzigartigen Werte zurück.

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

Ergebnis: (1, 2, 3)

Gibt eine neue Sequenz zurück, die durch das item-Parameter gebildet wird - und gleichzeitig an der von pos-Parameter angegebenen Position den Wert von inserts-Parameter einfü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")

Gibt die umgekehrte Reihenfolge der angegebenen Elemente zurück.

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

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

Beispiel: reverse(("ab"))

Ergebnis: ("ab")

Gibt die Projektionsfolge zurück, die vom start-Parameter angegebenen Positionen enthält, und deren Länge durch den len-Parameter festgelegt wird.

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)

Rückgabe des Durchschnittswerts der Werte der Parameter.

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

Ergebnis: 2

Rückgabe des Parameters, der größer als die anderen Parameter ist.

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

Ergebnis: 3

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

Ergebnis: 'k'

Rückgabe des Parameters, 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 Indexposition 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