XPath-Funktionen

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.

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 &gt; 1)"> gibt true zurück, wenn der Elementinhalt von element kleiner oder gleich 1 ist.

true ()

Gibt true zurück.

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.

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.