XPath-Funktionen

Welche von XPath 1.0 bereitgestellten Funktionen Sie in XSL-Mappings einsetzen können

Mit [eckigen Klammern] markierte Argumente sind optional.

Knotengruppen-Funktionen (node-set)

count(Knotengruppe)		Gibt die Anzahl der Knoten in `Knotengruppe` als ganze Zahl zurück
id (Id)		Wählt den Knoten mit der in `Id` angegebenen eindeutigen ID aus. Beispiel: `<xsl:value-of select="id('abc')/child::para"/>` Wählt Kindknoten `para` des Knotens mit der eindeutigen ID `abc` aus.
last ()		Gibt die Positionsnummer des letzten Knotens im aktuellen Kontext als ganze Zahl zurück. Beispiel: `<xsl:if test="position() = last()">` prüft, ob der aktuelle Knoten der letzte Knoten ist.
local-name ([Knotengruppe])		Gibt aus einem Knotennamen mit Namensraumangabe den lokalen Teil des Namens als Zeichenkette zurück. Optional kann als Argument eine `Knotengruppe` ausgewählt werden.
name ([Knotengruppe])		Gibt den Namen des aktuellen Knotens als Zeichenkette zurück. Optional kann als Argument eine `Knotengruppe` ausgewählt werden.
namespace-uri ([Knotengruppe])		Gibt den Namespace-URI (Uniform Resource Identifier) des aktuellen Element- oder Attributknotens als Zeichenkette zurück . Optional kann als Argument eine Knotengruppe ausgewählt werden. Beispiel: `<xsl:value-of select="namespace-uri()"/>` Gibt den Namespace-URI (sofern vorhanden) des aktuellen Knotens aus.
position ()		Gibt die Positionsnummer des aktuellen Knotens als ganze Zahl zurück. Der erste Knoten erhält die Positionsnummer `1`.

Boolesche Funktionen (boolean)

Boolesche XPath-Funktionen geben true/false-Werte zurück und können mit Vergleichsoperatoren verwendet werden.

boolean (Arg)		Prüft ein Argument `Arg` auf seine Wahrheit und gibt einen Booleschen Wert zurück. Alle Argumente, die eine positive Zahl, eine nicht-leere Zeichenkette oder eine nicht-leere Knotengruppe sind, werden als true interpertiert.
false ()		Gibt `false` zurück.
lang (Arg)		Gibt `true` zurück, wenn die in Argument `Arg` angegebene Sprache, die in einem `xml:lang`-Attribut angegeben wurde, mit der Sprachangabe des aktuellen Knotens mindestens zum Teil übereinstimmt. Beispiel: `lang("en")` gibt `true` zurück, wenn der aktuelle Knoten das Attribut `xml:lang="en"` besitzt oder wie in `xml:lang="en-US"` teilweise übereinstimmt.
not (Arg)		Gibt die Negation eines Booleschen Ausdrucks in Arg zurück. Beispiel: `<xsl:if test="not(element > 1)">` gibt `true` zurück, wenn der Elementinhalt von `element` kleiner oder gleich `1` ist.
true ()		Gibt `true` zurück.

Number-Funktionen

XPath-Number-Funktionen geben ganze Zahlen zurück und können mit Vergleichsoperatoren verwendet werden.

ceiling (Arg)		Rundet das Argument `Arg` auf die nächsthöhere ganze Zahl auf und gibt diese zurück (z. B. `0.001` auf `1`). Falls nötig wird zunächst das Argument in eine Zahl konvertiert. Mathematisch korrekt ausgedrückt: Gibt die kleinste ganze Zahl zurück, die nicht kleiner ist als das Argument `Arg`
floor (Arg)		Rundet das Argument `Arg` auf die nächstniedrigere ganze Zahl ab und gibt diese zurück (z. B. `0.999` auf `0`). Falls nötig wird zunächst das Argument in eine Zahl konvertiert. Mathematisch korrekt ausgedrückt: Gibt die größte ganze Zahl zurück, die nicht größer ist als das Argument `Arg`
number ([Arg])		Konvertiert den aktuellen Knoteninhalt in eine Zahl und gibt diese zurück. Optional kann ein Argument `Arg` eine Knotengruppe, eine Zeichenkette, einen Booleschen Wert oder ein anderes Objekt angeben, das konvertiert werden soll. Boolesche Werte `true` und `false` werden zu `1` und `0` konvertiert. Beispiel: Eine Zeichenkette `"3xy"` wird in `3` umgewandelt; `"xy"` als `NaN` (Not a Number) interpretiert.
round (Arg)		Rundet das Argument `Arg` zu einer ganzen positiven oder negativen Zahl auf oder ab und gibt diese zurück. Zahlen kleiner als `[Wert].5` werden abgerundet, bei Bruchgrößen größer oder gleich `[Wert].5` wird auf die nächsthöhere ganze Zahl aufgerundet. Beispiel: 0.49 wird zu 0 abgerundet, -1.5 wird zu -1 aufgerundet.
sum (Knotengruppe)		Bildet eine Gesamtsumme aller Knoteninhalte des Arguments `Knotengruppe` und gibt diese wenn möglich als Zahl zurück. Falls nötig werden zunächst die Knoteninhalte in Zahlen konvertiert. Können Werte nicht als Zahl interpretiert werden, dann werden diese als `NaN` (Not a Number) interpretiert.

Zeichenketten-Funktionen (String)

XPath-String-Funktionen verarbeiten Objekte und geben Zeichenketten oder bei Zeichenketten-Prüfungen Boolesche Werte zurück.

concat (Arg1, Arg2 [, ...])		Hängt mehrere Zeichenketten, die als Argumente `Arg1`, `Arg2` etc. übergeben werden, aneinander und gibt eine Zeichenkette zurück. Falls nötig werden zunächst die Argumente in Zeichenketten konvertiert.
contains (Arg, Substring)		Prüft, ob das Argument `Substring` in Argument `Arg` enthalten ist und gibt einen Booleschen Wert zurück. Falls nötig werden zunächst die Argumente in Zeichenketten konvertiert. Beispiel: `<xsl:if test="contains('SoftProject', 'Project')">` gibt den Booleschen Wert `true` zurück.
starts-with (Arg, Substring)		Prüft, ob das Argument `Arg` mit dem Argument `Substring` beginnt und gibt einen Booleschen Wert zurück. Falls nötig werden zunächst die Argumente in Zeichenketten konvertiert. Beispiel: `<xsl:if test="starts-with('SoftProject', 'Soft')">` gibt den Booleschen Wert `true` zurück.
normalize-space ([Arg])		Entfernt vom aktuellen Knoteninhalt die Leerzeichen am Anfang und Ende, ersetzt mehrfach aufeinanderfolgende Leerzeichen sowie Tabulatoren und Zeilenumbrüche durch ein einziges Leerzeichen und gibt den Knoteninhalt als Zeichenkette zurück Optional kann ein Argument `Arg` verwendet werden, das falls nötig zunächst in eine Zeichenkette konvertiert wird.
string ([Arg])		Konvertiert den aktuellen Knoteninhalt in eine Zeichenkette und gibt diese zurück. Optional kann ein Argument `Arg` verwendet werden. Boolesche Werte werden als Zeichenkette `true` oder `false` ausgegeben, Kommazahlen werden nach Möglichkeit vereinfacht. Für erweiterte Konvertierungen von Zahlen zu Zeichenketten die XSLT-Funktion `format-numbers()` verwenden; siehe XSLT-Funktionen. Beispiel: `<xsl:value-of select="string(4.00)"/>` gibt die Zeichenkette `4` zurück. Prüfen, ob ein Wert eine Zahl ist: `<xsl:if test="string(number(@value))!='NaN'">`.
string-length ([Arg])		Gibt die Anzahl der Zeichen des aktuellen Knoteninhalts als ganze Zahl zurück. Falls nötig wird zunächst das Argument in eine Zeichenkette konvertiert. Optional kann ein Argument `Arg` verwendet werden, das falls nötig zunächst in eine Zeichenkette konvertiert wird.
substring (Arg, Start [, Länge])		Extrahiert aus der Zeichenkette in Argument `Arg` eine Teilzeichenkette, die ab Zeichen `Start` beginnt und eine Zeichenkette zurückgibt. Die Zählung der Zeichen beginnt bei `1`. Optional kann das Argument `Länge` verwendet werden, das die maximale Länge der Teilzeichenkette angibt.
substring-before (Arg, Substring)		Prüft, ob die Zeichenkette in `Arg` vor der Teilzeichenkette in Argument `Substring` ein oder mehrere Zeichen besitzt und gibt diese als Zeichenkette zurück. Wenn `Substring` nicht in `Arg` enthalten ist, wird eine leere Zeichenkette zurückgegeben. Beispiel: `<xsl:value-of select="substring-before('2008/04/01', '/')"/>` gibt `2008` zurück.
substring-after (Arg, Substring)		Prüft, ob die Zeichenkette in `Arg` hinter der Teilzeichenkette in Argument `Substring` ein oder mehrere Zeichen besitzt und gibt die geänderte Zeichenkette zurück. Wenn `Substring` nicht in `Arg` enthalten ist, wird eine leere Zeichenkette zurückgegeben. Beispiel: `<xsl:value-of select="substring-after('2008/04/01', '20')"/>` gibt `08/04/01` zurück.
translate (Arg, Substring1, Substring2)		Sucht in Argument `Arg` nach der Zeichenkette in Argument `Substring1`, ersetzt diese durch die Zeichenkette in Argument `Substring2` und gibt die geänderte Zeichenkette zurück. Falls nötig wird zunächst das Argument `Arg` in eine Zeichenkette konvertiert. Jeder Treffer von `Substring1` wird durch `Substring2` ersetzt. Beispiel: `<xsl:value-of select="translate('hallo welt', 'abcdefghijklmnopqrstuvwxyz', 'ABCDEFGHIJKLMNOPQRSTUVWXYZ')" />` gibt `HALLO WELT` zurück.