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 Äqui­valent 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 ange­geben. 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-Funk­tionen 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