XPath: Umsetzung

Übersicht: XPath Umsetzung

• Location Paths
• Location Path-Beispiele
• Ausdrücke
• Funktionen
• Beispiele für Ausdrücke

• Einen Kontext- oder Ausgangsknoten
• Eine Kontextgröße (größer 0), die angibt, aus wievielen Knoten ausgewählt werden soll (z. B. Anzahl der Knoten im Dokument)
• Eine Kontextposition (größer 0 und kleiner oder gleich der Kontextgröße), die die Position des Kontextknotens angibt
• Eine Menge an definierten Variablen
• Eine Menge an Funktionen
• Die im Kontext gültigen Namespaces

   [/]schritt(/schritt)*

Die Verarbeitungsweise ist ähnlich wie bei Pfaden im Dateisystem:

• Ein Pfad wird von links nach rechts abgearbeitet.
• Pfadtrenner ist der Schrägstrich ("/").
• Beginnt der Pfad mit einem "/", so ist er ein absoluter Pfad, d. h. der Kontextknoten für den ersten Schritt ist der Wurzelknoten.
  Ansonsten ist er ein relativer Pfad und der Kontextknoten ist der aktuelle Knoten (definiert von der XPath-Anwendung).

   achse::typ([prädikat])*

achse gibt dabei das Verhältnis der gewünschten Knoten zum Kontextknoten an. Mögliche Werte sind:

Für jeden der durch achse ausgewählten Knoten wird geprüft, ob er vom angegebenen typ ist. Mögliche Werte sind:

Für alle Knoten, die jetzt noch ausgewählt sind, werden (falls vorhanden) die prädikate ausgewertet.
Die Prädikate sind XPath-Ausdrücke, deren genauer Aufbau unten erläutert wird.
Ein Knoten bleibt ausgewählt, wenn keine Prädikate angegeben sind oder für jedes Prädikat gilt:

• Das Prädikat ergibt TRUE oder
• das Prädikat ergibt eine Zahl und diese ist gleich der Position des Knotens in der Auswahl oder
• das Prädikat ergibt einen String oder ein Node-Set und ist nicht leer.

Jeder der so ausgewählten Knoten dient als Ausgangsknoten für den folgenden Schritt im Location Path.

Für häufig gebrauchte Schritte sind Abkürzungen definiert:

text()
child::text()

Dieser Location-Path wählt alle Textelemente aus, die direkte Nachkommen des Kontextknotens sind.

/html
/child::html

Wählt das html-Element aus, das ein Kind des Wurzelknotens sein muß.

//table
/descendant-or-self::node()/child::table

Wählt alle table-Tags im Dokument aus.

../table/@width
/parent::node()/child::table/attribute::width

Wählt die WIDTH-Attribute aller Tabellen aus, die Kinder des übergeordneten Knotens sind.

following-sibling::*/tr/td
following-sibling::*/child::tr/child::td

Wählt alle TD-Elemente aus, die innerhalb eines TR-Elements stehen, das in einem Bruderelement des aktuellen Elements steht.

In Ausdrücken dürfen folgende Elemente verwendet werden:

Typ	Aufruf	Beschreibung
node-set-Funktionen
number	last()	Gibt die Nummer des letzten Knotens (= Anzahl der Knoten) im Kontext zurück
number	position()	Gibt die Nummer des aktuellen Knotens im Kontext zurück
number	count(node-set)	Gibt die Anzahl der Knoten im Argument zurück
node-set	id(object)	Gibt das Element mit der Unique-ID object zurück
string	local-name(node-set?)	Liefert den lokalen Namen eines Knotens
string	namespace-uri(node-set?)	Liefert den namespace-URI eines Knotens
string	name()	Gibt den kompletten Namen eines Knotens zurück
string-Funktionen
string	string(object?)	Wandelt das Argument in einen string
string	concat(string, string, string*)	Gibt die Aneinanderreihung der Argumente zurück
boolean	starts-with(string, string)	Gibt TRUE zurück, wenn der erste string mit dem zweiten beginnt
boolean	contains(string, string)	Gibt TRUE zurück, wenn der zweite string im ersten enthalten ist
string	substring-before(string, string)	Gibt den string zurück, der vor dem ersten Auftreten des zweiten im ersten string liegt.
string	substring-after(string, string)	Gibt den string zurück, der hinter dem ersten Auftreten des zweiten im ersten string liegt.
string	substring(string, number, number?)	Gibt den string mit länge der zweiten Zahl zurück, der an der durch die erste nummer angegebenen position beginnt.
number	string-length(string?)	Gibt die Länge des strings zurück.
string	normalize-space(string?)	Entfernt Whitespaces am Anfang un Ende, sowie aufeinanderfolgende Whitespaces.
string	translate(string, string, string)	Ersetzt alle Vorkommen des zweiten strings im ersten durch den dritten
boolean-Funktionen
boolean	boolean(object)	Wandelt das Argument in ein boolean
boolean	not(boolean)	Führt eine not-Operation auf dem Argument aus
boolean	true()	Ergibt TRUE
boolean	false()	Ergibt FALSE
boolean	lang(string)	Gibt TRUE zurück, wenn die Sprache des Kontextknotens die durch string angegebene ist
number-Funktionen
number	number(object)	Wandelt das Argument in eine Zahl
number	sum(node-set)	Summiert alle in Zahlen konvertierten Knoten
number	floor(number)	Gibt die ganze Zahl zurück, die größer oder gleich dem Argument ist
number	ceiling(number)	Gibt die ganze Zahl zurück, die kleiner oder gleich dem Argument ist
number	round(number)	Rundet das Argument kaufmännisch

/html/body/table[2]
/child::html/child::body/child::html[2]

Die zweite Tabelle, die direkt im Body steht (keine geschachtelten Tabellen).

//table[@width = "50%"]
/descendant-or-self::table[attribute::width = "50%"]

Alle Tabellen im Dokument, die "50%" als Breite angegeben haben.

//td[position() != last()]

Alle TD-Elemente im Dokument mit Ausnahme des letzten.

//ex:head

Alle HEAD-Elemente, die im Namespace ex deklariert sind.

//*[local-name() = 'head' and namespace-uri() = 'http://www.example.org']

Allgemeinere Form von //ex:head, wenn ex als xmlns:ex="http://www.example.org" deklariert wurde.