XSLT- und XPath-Funktionen in alphabetischer Reihenfolge
(Auszug aus "XSLT 2.0 & XPath 2.0" von Frank Bongers, Kapitel 5.)
A | B | C | D | E | F | G | H | I | J | K | L | M | N | O | P | Q | R | S | T | U | V | W | X | Y | Z
In der folgenden, alphabetisch nach Funktionsnamen geordneten Übersicht sind alle im Rahmen von XSLT 2.0 und XPath 2.0/XQuery 1.0 definierten Funktionen angeführt.
Es bleiben weiterhin alle in XSLT 1.0 und XPath 1.0 eingeführten Funktionen nutzbar. Einige XSLT 1.0-Funktionen wurden jedoch den XPath-Core-Funktionen hinzugefügt, um sie auch außerhalb des XSLT-Kontextes (z.B. im Rahmen von XQuery) nutzbar zu machen; für andere wurde in XPath ein zusätzliches Äquivalent geschaffen.
Erklärung zur Übersicht
Auf den folgenden Seiten wird jede beschriebene Funktion funktional einer Kategorie zugeordnet und ihre Herkunft aus entweder XSLT 1.0/XPath 1.0 oder XSLT 2.0/XPath 2.0 angegeben. Bei Funktionen aus XSLT 1.0, die neuerdings auch dem XPath 2.0 Core angehören, wird dies entsprechend vermerkt. Beschrieben werden zunächst der Rückgabewert der Funktion und die Anzahl und der Typ der beim Aufruf erwarteten Argumente. Anschließend wird der Verwendungszweck der Funktion erläutert und anhand von Beispielen dargestellt. Die Signaturen der Funktion werden in Form ihrer Funktionsdefinitionen angegeben und, wo möglich, die Definitionen der Versionsstände einander gegenübergestellt.
Die aus XSLT stammenden Funktionen befinden sich im XSLT-Namensraum und benötigen, da sie nur in diesem Kontext eingesetzt wer-den, kein ausdrückliches Namensraumpräfix.
Die in XPath 2.0 gültigen Funktionen werden allgemein mit dem Präfix fn versehen, der sich auf folgenden Namensraum bezieht:
xmlns:fn="http://www.w3.org/2005/xpath-functions"
Hinweis: Wird im Rahmen der folgenden Beschreibungen auf XPath-Funktionen mit vorangestelltem Präfix fn: Bezug genommen, so wird ihr Verhalten im XPath 2.0-Kontext beschrieben. In den meisten Fällen ist das Verhalten der gleichnamigen Funktionen, sofern vorhanden, in XPath 1.0 weitestgehend identisch. Wird die Funktion ohne Präfix genannt (sofern es sich nicht um eine XSLT-Funktion handelt), ist die entsprechende Passage jedoch ausdrücklich im XPath 1.0-Kontext zu verstehen.
A
fn:abs() | absoluter Wert der Eingabezahl |
fn:adjust-date-to-timezone() | Datum an Zeitzone anpassen |
fn:adjust-dateTime-to-timezone() | Zeitpunt an Zeitzone anpassen |
fn:adjust-time-to-timezone() | Tageszeit an Zeitzone anpassen |
fn:avg() | Durchschnitt aus Eingabewerten |
nach oben |
B
fn:base-uri() | Accessor; Basis-URI eines Knotens |
fn:boolean() | Wandlung in booleschen Wert |
nach oben |
C
fn:ceiling() | Aufrundung Eingabezahl |
fn:codepoint-equal() | Unicode-Codepoint-Vergleich |
fn:codepoints-to-string() | Unicode-Codepoint in String |
fn:collection() | Sequenz mehrerer Document-Nodes aus Eingabestring |
fn:compare() | Test zweiser Strings auf Gleichheit |
fn:concat() | Stringaddition |
fn:contains() | Test auf Substring im Prüfstring |
fn:count() | Knotenzahl in Nodeset |
current() | aktueller Knoten |
fn:current-date() | aktuelles Datum |
fn:current-dateTime() | aktuelles Datum und Tageszeit |
current-group() | aktuelle Gruppe einer Gruppierung |
current-grouping-key() | aktueller Gruppierschlüssel |
fn:current-time() | aktuelle Tageszeit |
nach oben |
D
fn:data() | Eingangssequenz in atomare Werte umwandeln |
fn:dateTime() | Konstruktor für Zeitstempelwert |
fn:day-from-date() | Tag aus Datum |
fn:day-from-dateTime() | Tag aus Zeitpunkt |
fn:days-from-duration() | Tage aus Zeitraum |
fn:deep-equal() | Gleichheit zweier Sequenzen feststellen |
fn:default-collation() | URI der Default-Collation |
fn:distinct-values() | identische Werte aus Sequenz entfernen |
fn:doc() | Einbindung genau eines externen Dokuments (ohne Basis-URI) |
fn:doc-available() | Prüfen der Verfügbarkeit eines externen Dokuments |
document() | Einbindung eines oder mehrerer externer Dokumente (mit Basis-URI) |
fn:document-uri() | URI des zugehörigen Document-Nodes eines übergebenen Nodes |
nach oben |
E
element-available() | Verfügbarkeit einer Instruktion |
fn:empty() | gibt true für eine leere Sequenz zurück |
fn:encode-for-uri() | String-Rückgabe in encodierter Form als URI-String |
fn:ends-with() | Test auf Substring am Stringende |
fn:error() | Fehlerausgabe |
fn:escape-html-uri() | URI-String escapen |
fn:exactly-one() | gibt Eingangssequenz aus genau einem Item zurück, sonst Fehler |
fn:exists() | gibt true für eine nicht leere Sequenz zurück |
nach oben |
F
fn:false() | boolescher Wert false |
fn:floor() | Abrundung Eingabezahl |
format-date() | Formatierung Datum in String |
format-dateTime() | Formatierung Zeitpunkt in String |
format-number() | Formatierung Zahl nach String |
format-time() | Formatierung Tageszeit in String |
function-available() | Verfügbarkeit einer Funktion |
nach oben |
G
generate-id() | ID zur Laufzeit erzeugen |
nach oben |
H
fn:hours-from-dateTime() | Stunden aus Zeitpunkt |
fn:hours-from-duration() | Stunden aus Zeitraum |
fn:hours-from-time() | Stunden aus Tageszeit |
nach oben |
I
fn:id() | gibt eine Sequenz von Nodes mit übergebenem ID-Wert zurück |
fn:idref() | Sequenz von Nodes mit übergebenem IDREF-Wert |
fn:implicit-timezone() | implizite Zeitzone |
fn:in-scope-prefixes() | Präfixe gültiger Namensräume zurückgeben |
fn:index-of() | gibt Index(e) des (der) Items mit übergebenem Vergleichswert zurück |
fn:insert-before() | fügt Item(s) an übergebener Position in Sequenz ein |
fn:iri-to-uri() | wandelt IRI-String in URI-String um |
nach oben |
K
key() | Node finden mit definiertem Schlüssel |
nach oben |
L
fn:lang() | Sprachbestimmung (jetzt XPath-Core-Funktion) |
fn:last() | Index des letzten Knotens im Set |
fn:local-name() | lokaler Teil des QNames |
fn:local-name-from-QName() | lokalen Bezeichner als String extrahieren |
fn:lower-case() | in Kleinbuchstaben umwandeln |
nach oben |
M
fn:matches() | Test auf Patternmatching |
fn:max() | Maximum aus Eingabewerten |
fn:min() | Minimum aus Eingabewerten |
fn:minutes-from-dateTime() | Minuten aus Zeitpunkt |
fn:minutes-from-duration() | Minuten aus Zeitraum |
fn:minutes-from-time() | Minuten aus Tageszeit |
fn:month-from-date() | Monat aus Datum |
fn:month-from-dateTime() | Monat aus Zeitpunkt |
fn:months-from-duration() | Monate aus Zeitraum |
nach oben |
N
fn:name() | QName eines Knotens (abwärtskompatibel) |
fn:namespace-uri() | Namesraum-URI eines Knotens |
fn:namespace-uri-for-prefix() | Namesraum-URI des übergebenen Präfixes |
fn:namespace-uri-from-QName() | Namesraum-URI eines QNames extrahieren |
fn:nilled() | Accessor; meldet nilled-Zustand eines Elementknotens als booleschen Wert |
fn:node-name() | expandierter QName eines Knotens |
fn:normalize-space() | Normalisierung von Weißraum |
fn:normalize-unicode() | gibt Unicode-Normalform zurück |
fn:not() | boolesche Negation |
fn:number() | Wandlung in Zahl |
nach oben |
O
fn:one-or-more() | gibt Eingangssequenz aus einem oder mehr Items zurück, sonst Fehler |
nach oben |
P
fn:position() | Index des aktuellen Knotens im Set |
fn:prefix-from-QName() | Präfix des Namensraums zurückgeben |
nach oben |
Q
fn:QName() | Konstruktor; gibt QName zurück |
nach oben |
R
regex-group() | aktuelle Gruppe des Ergebnisses eines regulären Ausdrucksstat |
fn:remove() | entfernt Item an der bezeichneten Position aus Sequenz |
fn:replace() | Ersetzen mit Patternmatching |
fn:resolve-QName() | Konstruktor; wandelt String in expandierten QName um |
fn:resolve-uri() | löst relative URI-Angabe mit Basis-URI auf |
fn:reverse() | kehrt Reihenfolge der Items einer Sequenz um |
fn:root() | Wurzelknoten bezüglich des Baums eines Eingabeknotens |
fn:round() | Auf- oder Abrundung Eingabezahl |
fn:round-half-to-even() | Rundung mit variabler Präzision |
nach oben |
S
fn:seconds-from-dateTime() | Sekunden aus Zeitpunkt |
fn:seconds-from-duration() | Sekunden aus Zeitraum |
fn:seconds-from-time() | Sekunden aus Tageszeit |
fn:starts-with() | Test auf Substring am Stringanfang |
fn:static-base-uri() | Basis-URI des statischen Kontexts |
fn:string() | Wandlung in String |
fn:string-join() | Strings mit übergebenem Separator zusammenfassen |
fn:string-length() | Zeichenanzahl im Prüfstring |
fn:string-to-codepoints() | String in Unicode-Codepoint |
fn:subsequence() | bildet Untersequenz anhand übergebener Indexziffern |
fn:substring() | Extraktion eines Substrings |
fn:substring-after() | Teilstring nach Trennsymbol |
fn:substring-before() | Teilstring vor Trennsymbol |
fn:sum() | Addition von vValues eines Nodesets |
system-property() | Auslesen der Systemeigenschaften der Laufzeitumgebung |
nach oben |
T
fn:timezone-from-date() | Zeitzone aus Datum |
fn:timezone-from-dateTime() | Zeitzone aus Zeitpunkt |
fn:timezone-from-time() | Zeitzone aus Tageszeit |
fn:tokenize() | Splitten eines Eingabestrings mit Patternmatching |
fn:trace() | Führen eines Debugging-Logs |
fn:translate() | Zeichenersetzung nach Muster |
fn:true() | boolescher Wert true |
type-available() | Verfügbarkeit eines Schema-Typs |
nach oben |
U
fn:unordered() | erlaubt eine beliebige Ausgabereihenfolge einer Sequenz |
unparsed-entity-public-id() | Public-ID eines ungeparsten, externen Entities |
unparsed-entity-uri() | URI eines ungeparsten, externen Entities (DTD) |
unparsed-text() | externen, ungeparsten Text einbinden |
unparsed-text-available() | prüfen der Verfügbarkeit eins externen Textobjekts |
fn:upper-case() | in Großbuchstaben umwandeln |
nach oben |
Y
fn:year-from-date() | Jahr aus Datum |
fn:year-from-dateTime() | Jahr aus Zeitpunkt |
fn:years-from-duration() | Jahre aus Zeitraum |
nach oben |
Z
fn:zero-or-one() | gibt Eingangssequenz aus null oder einem Item zurück, sonst Fehler |
nach oben |
<< zurück | vor >> |
Tipp der data2type-Redaktion: Zum Thema XSLT bieten wir auch folgende Schulungen zur Vertiefung und professionellen Fortbildung an: |
Copyright © Galileo Press, Bonn 2008
Für Ihren privaten Gebrauch dürfen Sie die Online-Version ausdrucken.
Ansonsten unterliegt dieses Kapitel aus dem Buch "XSLT 2.0 & XPath 2.0 ― Das umfassende Handbuch" denselben Bestimmungen wie die gebundene Ausgabe: Das Werk einschließlich aller seiner Teile ist urheberrechtlich geschützt. Alle Rechte vorbehalten einschließlich der Vervielfältigung, Übersetzung, Mikroverfilmung sowie Einspeicherung und Verarbeitung in elektronischen Systemen.
Galileo Press, Rheinwerkallee 4, 53227 Bonn