XMLNodeFromPath()
Syntax
*Ergebnis = XMLNodeFromPath(*ElternKnoten, Pfad$)Beschreibung
Gibt den XML-Knoten innerhalb des '*ElternKnoten' (übergeordneter Knoten, in englisch "ParentNode") zurück, dessen Verbindung zum '*ElternKnoten' mittels des 'Pfad$' beschrieben wird. XMLNodePath() kann verwendet werden, um einen solchen Pfad zu einem Knoten zu erhalten.
Parameter
*ElternKnoten Der übergeordnete XML-Knoten. Pfad$ Beinhaltet eine Liste von durch '/' getrennten Knoten-Namen, um den Weg vom Elternknoten zum Zielknoten aufzuzeigen. Zum Beispiel definiert "childtag/subchildtag" den ersten Knoten mit dem Namen "subchildtag" innerhalb des ersten Knoten mit Namen "childtag" innerhalb des '*ElternKnoten'.
Ein Knotenname kann einen Index (beginnend bei eins) haben, um genau zu spezifieren, welchen von mehreren 'Child-Tags' (untergeordnete "Kinderknoten") mit dem gleichen Namen ausgewählt werden sollen. "childtag/subchildtag[3]" definiert den dritten "subchildtag" innerhalb des ersten "childtag" vom '*ElternKnoten'.
Andere Regeln:
- Wenn ein Pfad mit '/' beginnt, ist dieser relativ zur Wurzel des Baums - ganz gleich, welchen Knoten '*ElternKnoten' spezifiziert.
- Ein Platzhalter "*" kann anstelle eines Tag-Namens verwendet werden, um damit anzugeben, dass jeder Tag ausgewählt werden soll.
- Ein Kommentar-Knoten hat den Tag-Namen "#comment".
- Ein CData-Knoten hat den Tag-Namen "#cdata".
- Ein DTD-Knoten hat den Tag-Namen "#dtd".
- Eine Verarbeitungsanweisung hat den Tag-Namen "#instruction".
Einige Beispiele für gültige Pfade:"/mainnode/#comment[4]" - der vierte Kommentar innerhalb des "mainnode" Knotens ausgehend von der Wurzel des Baums "*[10]" - der zehnte Knoten (jeden Typs) innerhalb vom '*ElternKnoten' "*/*/*" - der ersten Knoten 3 Ebenen (Level) unterhalb vom '*ElternKnoten' unabhängig von seinem Typ "node[3]/*[3]/#cdata" - die erste CData Sektion innerhalb des dritten Knotens (beliebiger Art) innerhalb des dritten Knotens "node" innerhalb vom '*ElternKnoten'Hinweis: Dieser Befehl ist keine Implementation der XPath Spezifikation. Der verwendete und von diesem Befehl verstandene Syntax ist nur eine kleine Untermenge von XPath. Dies bedeutet, ein von XMLNodePath() zurückgegebener Pfad ist eine gültige XPath Abfrage, aber dieser Befehl versteht nur den hier beschriebenen Syntax, nicht generell jede XPath Abfrage.
Rückgabewert
Gibt den Zeiger des Zielknotens zurück - oder Null, wenn der Pfad nicht zu einem gültigen Knoten führte.
Siehe auch
XMLNodePath()
Unterstützte OS
Alle