XPath-Standardfunktionen

Der Publisher unterstützt die folgenden XPath-Standardfunktionen. Daneben gibt es die Publisher-spezifischen Layoutfunktionen und selbstdefinierte Funktionen.

Zeichenketten

concat(<Wert>,<Wert>, ...)

Erzeugt einen neuen Text aus der Verkettung der Werte.

contains(<Heuhaufen>,<Nadel>)

Wahr, wenn Heuhaufen die Nadel enthält. Beispiel: contains('bana','na') ergibt true().

starts-with(<String>, <String>)

Wahr, wenn die erste Zeichenkette mit der zweiten anfängt.

ends-with(<String>, <String>)

Wahr, wenn die erste Zeichenkette mit der zweiten endet.

substring(<Eingabe>,<Start>[,<Länge>])

Gibt einen Teil der Zeichenkette zurück. substring('Goldfarb', 5, 3) gibt far zurück. Start kann auch negativ sein (zählt vom Ende).

substring-before(<String>,<String>)

Gibt den Teil der ersten Zeichenkette zurück, der vor der zweiten steht. Beispiel: substring-before("tattoo", "attoo") ergibt "t".

substring-after(<String>,<String>)

Gibt den Teil der ersten Zeichenkette zurück, der nach der zweiten steht. Beispiel: substring-after("tattoo", "tat") ergibt "too".

string-length(<String>)

Gibt die Länge der Zeichenkette zurück. Multibyte-UTF-8-Sequenzen werden als eine Position gezählt.

string-join(<Sequenz>, <Separator>)

Verbindet die Elemente der Sequenz mit dem Separator.

normalize-space(<Text>)

Entfernt führende und nachstehende Leerzeichen. Mehrfache Leerzeichen und Zeilenumbrüche werden durch ein einzelnes Leerzeichen ersetzt.

upper-case(<Text>)

Wandelt den Text in Großbuchstaben. upper-case('Text') ergibt TEXT.

lower-case(<Text>)

Wandelt den Text in Kleinbuchstaben. lower-case('Text') ergibt text.

translate(<Eingabe>,<Von>,<Nach>)

Ersetzt alle Zeichen in Eingabe, die in Von vorkommen, durch das entsprechende Zeichen in Nach. Beispiel: translate('banana','an','uo') ergibt buouou. Wenn Nach kürzer als Von ist, werden überzählige Zeichen gelöscht.

compare(<String>,<String>)

Vergleicht zwei Zeichenketten: ergibt -1, wenn die erste Zeichenkette kleiner als die zweite ist, 0, wenn beide gleich sind, und 1, wenn sie größer ist. Beispiel: compare('a','b') ergibt -1.

matches(<Text>,<Regexp>[,<Flags>])

Prüft, ob der Text auf den regulären Ausdruck passt. Flags: s, i, m (siehe XPath-Spezifikation). Beispiel: matches("banana", "^(.a)+$") ergibt wahr.

replace(<Eingabe>,<Regexp>,<Ersetzung>)

Ersetzt alle Treffer des regulären Ausdrucks durch den Ersetzungstext. Beispiel: replace('banana', 'a', 'o') ergibt bonono. Mit Gruppen: replace('W151TBH','^[A-Z]([0-9]+)[A-Z]+$', '$1') ergibt 151.

tokenize(<Eingabe>,<Regexp>)

Zerlegt die Eingabe anhand des regulären Ausdrucks in eine Sequenz von Zeichenketten. Beispiel: tokenize("Go home, Jack!", "\W+") ergibt die Sequenz "Go", "home", "Jack", "".

string(<Sequenz>)

Gibt den Textwert der Sequenz zurück.

codepoints-to-string(<Codepoints>)

Konvertiert eine Sequenz von Codepoints in eine Zeichenkette.

string-to-codepoints(<String>)

Konvertiert eine Zeichenkette in eine Sequenz von Codepoints.

Zahlen

number(<Wert>)

Konvertiert den Wert in eine Zahl. Falls nicht möglich, wird NaN zurückgegeben.

abs(<Zahl>)

Gibt den Absolutwert zurück. abs(-1.34) ergibt 1.34.

ceiling(<Zahl>)

Rundet auf die nächsthöhere Ganzzahl. ceiling(1.34) ergibt 2.

floor(<Zahl>)

Rundet auf die nächstniedrigere Ganzzahl. floor(1.7) ergibt 1.

round(<Zahl>[,<Nachkommastellen>])

Rundet auf die angegebene Anzahl Nachkommastellen (Voreinstellung: 0).

round-half-to-even(<Zahl>[,<Nachkommastellen>])

Rundet kaufmännisch (Banker’s Rounding): bei .5 wird auf die nächste gerade Zahl gerundet.

format-number(<Zahl>, <Muster>)

Formatiert die Zahl nach dem Muster. Beispiel: format-number(12345.67, '#,##0.00') ergibt 12,345.67.

max(<Sequenz>)

Gibt das Maximum zurück. max((1.1, 2.2, 3.3)) ergibt 3.3.

min(<Sequenz>)

Gibt das Minimum zurück. min((1.1, 2.2, 3.3)) ergibt 1.1.

sum(<Sequenz>[,<Nullwert>])

Gibt die Summe der Werte zurück. sum((1, 2, 3)) ergibt 6. Bei einer leeren Sequenz wird 0 zurückgegeben, oder das zweite Argument, falls angegeben.

avg(<Sequenz>)

Gibt den Durchschnitt der Werte zurück. avg((1, 2, 3)) ergibt 2.0. Bei einer leeren Sequenz wird die leere Sequenz zurückgegeben.

Boolesche Funktionen

true()

Gibt wahr zurück.

false()

Gibt falsch zurück.

not(<Wert>)

Negiert den Wahrheitswert. not(true()) ergibt false().

boolean(<Sequenz>)

Gibt den effektiven Booleschen Wert zurück.

empty(<Sequenz>)

Wahr, wenn die Sequenz leer ist (z.B. ein nicht vorhandenes Attribut oder Element).

exists(<Sequenz>)

Wahr, wenn die Sequenz nicht leer ist. Das Gegenteil von empty().

Sequenzen und Knoten

count(<Knoten>)

Zählt die Kindelemente mit dem angegebenen Namen. Beispiel: count(article).

position()

Gibt die Position des aktuellen Datensatzes zurück.

last()

Gibt die Anzahl der gleichnamigen Geschwister-Elemente zurück.

distinct-values(<Sequenz>)

Gibt die eindeutigen Werte zurück. distinct-values((1,2,2,3)) ergibt (1,2,3).

reverse(<Sequenz>)

Kehrt die Reihenfolge der Sequenz um.

index-of(<Sequenz>,<Suchwert>)

Gibt die Positionen der Einträge zurück, die gleich dem Suchwert sind. index-of((10, 20, 30, 20), 20) ergibt (2, 4).

insert-before(<Sequenz>,<Position>,<Einträge>)

Fügt die Einträge an der angegebenen Position ein. insert-before(('a', 'b'), 2, 'x') ergibt ('a', 'x', 'b'). Positionen außerhalb der Sequenz fügen am Anfang bzw. am Ende ein.

remove(<Sequenz>,<Position>)

Entfernt den Eintrag an der angegebenen Position. remove(('a', 'b', 'c'), 2) ergibt ('a', 'c').

subsequence(<Sequenz>,<Start>[,<Länge>])

Gibt den Teil der Sequenz ab der Position Start zurück (der erste Eintrag ist 1). Ohne Länge wird alles bis zum Ende zurückgegeben. subsequence((1, 2, 3, 4), 2, 2) ergibt (2, 3).

deep-equal(<Sequenz>,<Sequenz>)

Wahr, wenn beide Sequenzen gleich lang sind und alle Einträge gleich sind. Elemente werden rekursiv verglichen, einschließlich ihrer Attribute und Inhalte.

zero-or-one(<Sequenz>)

Gibt die Sequenz zurück, wenn sie höchstens einen Eintrag enthält, sonst wird ein Fehler ausgelöst.

one-or-more(<Sequenz>)

Gibt die Sequenz zurück, wenn sie mindestens einen Eintrag enthält, sonst wird ein Fehler ausgelöst.

exactly-one(<Sequenz>)

Gibt die Sequenz zurück, wenn sie genau einen Eintrag enthält, sonst wird ein Fehler ausgelöst.

local-name()

Gibt den Namen des aktuellen Knotens zurück (ohne Namensraum).

name()

Gibt den Namen des aktuellen Knotens zurück (mit Namensraum-Präfix).

namespace-uri([<Knotensequenz>])

Gibt den Namensraum-URI des ersten Knotens zurück.

root(<Element>)

Gibt das Wurzelelement zurück.

doc(<Dateiname>)

Öffnet die Datei und gibt den Inhalt als XML-Baum zurück.

serialize(<Knoten>)

Gibt die XML-Serialisierung des Knotens als Zeichenkette zurück. Beispiel: Wenn das aktuelle Element <item color="red">Text</item> ist, ergibt serialize(.) die Zeichenkette <item color="red">Text</item>. Sonderzeichen werden korrekt escaped (&, <, >, ").

unparsed-text(<Dateiname>)

Gibt den Inhalt der Datei als uninterpretierten Text zurück.

Arrays und Maps

Die Funktionen der Namensräume array: und map: sind im Kapitel Arrays und Maps beschrieben, zusammen mit den nötigen Namensraum-Deklarationen und Beispielen.