XML Referenzhandbuch

• Element (max. eins)
• ProcessingInstruction
• Kommentar
• DocumentType

• ProcessingInstruction
• Kommentar
• Text
• CDATASection
• EntityReference

• ProcessingInstruction
• Kommentar
• Text
• CDATASection
• EntityReference

• Text
• Kommentar
• ProcessingInstruction
• CDATASection
• EntityReference

• Text
• EntityReference

• ProcessingInstruction
• Kommentar
• Text
• CDATASection
• EntityReference

Returns the object associated with the key on the node.

The object must be set to this node first, by calling setUserData with the same key.

normalize() 方法移除空的文本节点，并连接相邻的文本节点。

将元素下的所有文本节点（包括属性）正规化，其中仅结构（例如元素、注释、处理指令、CDATA 部分和实体引用）分隔文本节点。

即，既不存在相邻的文本节点，也不存在空的文本节点。

If the attribute value is set in the document, return true;

If the attribute value is the default value in DTD/Schema, return false.

Specify the type of request, URL, whether the request should be processed asynchronously, and other optional properties of the request.

• method: 请求类型：GET 或 POST
• url: 文件在服务器上的位置
• async: true（异步）或 false（同步）

将请求发送到服务器。

string：仅用于 POST 请求

保存 XMLHttpRequest 的状态。从 0 到 4 的变化：

• 0: 请求未初始化
• 1: 服务器连接已建立
• 2: 请求收到
• 3: 请求处理中
• 4: 请求已完成，响应已就绪

• fn:base-uri()
• fn:base-uri(node)

• fn:error()
• fn:error(error)
• fn:error(error,description)
• fn:error(error,description,error-object)

Beispiel: error(fn:QName('http://example.com/test', 'err:toohigh'), 'Error: Price is too high')

Ergebnis: Gibt http://example.com/test#toohigh sowie den String "Error: Price is too high" an die externe Verarbeitungsumgebung zurück.

Gibt den numerischen Wert des Arguments zurück. Das Argument kann ein boolescher Wert, ein String oder ein Knoten-Set sein.

Beispiel: number('100')

Ergebnis: 100

Gibt den Absolutwert des Arguments zurück.

Beispiel: abs(3.14)

Ergebnis: 3.14

Beispiel: abs(-3.14)

Ergebnis: 3.14

Gibt den kleinsten ganzen Zahl zurück, der größer als das Argument num ist.

Beispiel: ceiling(3.14)

Ergebnis: 4

Rückgabe des größten Ganzzahls, das nicht größer als den Parameter num ist.

Beispiel: floor(3.14)

Ergebnis: 3

Rundung des Parameters num auf die nächstgelegene Ganzzahl.

Beispiel: round(3.14)

Ergebnis: 3

Beispiel: round-half-to-even(0.5)

Ergebnis: 0

Beispiel: round-half-to-even(1.5)

Ergebnis: 2

Beispiel: round-half-to-even(2.5)

Ergebnis: 2

Rückgabe des Zeichenfolgenrechtes des Arguments. Das Argument kann eine Zahl, ein logisches Wert oder ein Knotensatz sein.

Beispiel: string(314)

Ergebnis: "314"

Rückgabe der Zeichenfolge basierend auf der Sequenz von Zeichencodes.

Beispiel: codepoints-to-string(84, 104, 233, 114, 232, 115, 101)

Ergebnis: 'Thérèse'

Rückgabe der Sequenz von Zeichencodes basierend auf der Zeichenfolge.

Beispiel: string-to-codepoints("Thérèse")

Ergebnis: 84, 104, 233, 114, 232, 115, 101

• fn:compare(comp1,comp2)
• fn:compare(comp1,comp2,collation)

Wenn comp1 kleiner als comp2 ist, wird -1 zurückgegeben. Wenn comp1 gleich comp2 ist, wird 0 zurückgegeben. Wenn comp1 größer als comp2 ist, wird 1 zurückgegeben. (Abhängig vom verwendeten Vergleichsregeln).

Beispiel: compare('ghi', 'ghi')

Ergebnis: 0

Rückgabe der Verknüpfung von Zeichenfolgen.

Beispiel: concat('XPath ','ist ','FUN!')

Ergebnis: 'XPath ist FUN!'

Verwendet den sep-Parameter als Trennzeichen, um den verbundenen String der string-Parameter zurückzugeben.

Beispiel: string-join(('We', 'are', 'having', 'fun!'), ' ')

Ergebnis: ' We are having fun! '

Beispiel: string-join(('We', 'are', 'having', 'fun!'))

Ergebnis: 'Wearehavingfun!'

Beispiel: string-join((), 'sep')

Ergebnis: ''

• fn:substring(string,start,len)
• fn:substring(string,start)

Gibt einen vom start-Position beginnenden, angegebenen Längen unteren Teilstring zurück. Der Index des ersten Zeichens ist 1. Wenn der Parameter len weggelassen wird, wird der Teilstring von der Position start bis zum Ende des Strings zurückgegeben.

Beispiel: substring('Beatles',1,4)

Ergebnis: 'Beat'

Beispiel: substring('Beatles',2)

Ergebnis: 'eatles'

• fn:string-length(string)
• fn:string-length()

Gibt die Länge des angegebenen Strings zurück. Wenn kein string-Parameter angegeben ist, wird die Länge des String-Werts des aktuellen Knotens zurückgegeben.

Beispiel: string-length('Beatles')

Ergebnis: 7

• fn:normalize-space(string)
• fn:normalize-space()

Entfernt den angegebenen String am Anfang und am Ende und ersetzt alle internen Leerzeichenfolgen durch ein Leerzeichen, und gibt das Ergebnis zurück. Wenn kein string-Parameter angegeben ist, wird der aktuelle Knoten verarbeitet.

Beispiel: normalize-space(' The　　　XML ')

Ergebnis: 'The XML'

Konvertiert den string-Parameter in Großbuchstaben.

Beispiel: upper-case('The XML')

Ergebnis: 'THE XML'

Konvertiert den string-Parameter in Kleinbuchstaben.

Beispiel: lower-case('The XML')

Ergebnis: 'the xml'

Ersetzt string2 in string1 durch string3.

Beispiel: translate('12:30','30','45')

Ergebnis: '12:45'

Beispiel: translate('12:30','03','54')

Ergebnis: '12:45'

Beispiel: translate('12:30','0123','abcd')

Ergebnis: 'bc:da'

Beispiel: escape-uri("http://example.com/test#car", true())

Ergebnis: "http%3A%2F%2Fexample.com%2Ftest#car"

Beispiel: escape-uri("http://example.com/test#car", false())

Ergebnis: "http://example.com/test#car"

Beispiel: escape-uri ("http://example.com/~bébé", false())

Ergebnis: "http://example.com/~b%C3%A9b%C3%A9"

Gibt true zurück, wenn string1 string2 enthält, sonst false.

Beispiel: contains('XML','XM')

Ergebnis: true

Gibt true zurück, wenn string1 mit string2 beginnt, sonst false.

Beispiel: starts-with('XML','X')

Ergebnis: true

Gibt true zurück, wenn string1 mit string2 endet, sonst false.

Beispiel: ends-with('XML','X')

Ergebnis: false

Rückgibt den Teilstring, der vor dem Auftreten von string2 in string1 folgt.

Beispiel: substring-before('12/10','/')

Ergebnis: '12'

Rückgibt den Teilstring, der nach dem Auftreten von string2 in string1 folgt.

Beispiel: substring-after('12/10','/')

Ergebnis: '10'

Gibt true zurück, wenn der Wert des Strings dem angegebenen Muster entspricht, sonst false.

Beispiel: matches("Merano", "ran")

Ergebnis: true

Ersetzt das angegebene Muster durch den replace-Parameter und gibt das Ergebnis zurück.

Beispiel: replace("Bella Italia", "l", "*")

Ergebnis: 'Be**a Ita*ia'

Beispiel: replace("Bella Italia", "l", "")

Ergebnis: 'Bea Itaia'

Beispiel: tokenize("XPath is fun", "\s+")

Ergebnis: ("XPath", "is", "fun")

Zuerst wird der Parameter durch die Funktion boolean() in einen booleschen Wert umgewandelt.

Gibt true zurück, wenn der boolesche Wert false ist, sonst true.

Beispiel: not(true())

Ergebnis: false

Rückgabe eines booleschen Wertes true.

Beispiel: true()

Ergebnis: true

Rückgabe eines booleschen Wertes false.

Beispiel: false()

Ergebnis: false

Gibt die lokale Wertangabe des Parameters als Integer des Jahresanteils zurück.

Beispiel: year-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Ergebnis: 2005

Gibt die lokale Wertangabe des Parameters als Integer des Monatsanteils zurück.

Beispiel: month-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Ergebnis: 01

Gibt die lokale Wertangabe des Parameters als Integer des Tagesanteils zurück.

Beispiel: day-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Ergebnis: 10

Gibt die lokale Wertangabe des Parameters als Integer des Stundenanteils zurück.

Beispiel: hours-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Ergebnis: 12

Gibt die lokale Wertangabe des Parameters als Integer des Minutenanteils zurück.

Beispiel: minutes-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Ergebnis: 30

Gibt die lokale Wertangabe des Parameters als Dezimalzahl des Sekundenanteils zurück.

Beispiel: seconds-from-dateTime(xs:dateTime("2005-01-10T12:30:00-04:10"))

Ergebnis: 0

Gibt die lokale Wertangabe des Parameters als Integer des Jahres zurück.

Beispiel: year-from-date(xs:date("2005-04-23"))

Ergebnis: 2005

Gibt die Integer-Zeile im lokalen Wert des Parameters zurück, die den Monat repräsentiert.

Beispiel: month-from-date(xs:date("2005-04-23"))

Ergebnis: 4

Gibt die Integer-Zeile im lokalen Wert des Parameters zurück, die den Tag repräsentiert.

Beispiel: day-from-date(xs:date("2005-04-23"))

Ergebnis: 23

Gibt die Integer-Zeile im lokalen Wert des Parameters zurück, die die Stunden repräsentiert.

Beispiel: hours-from-time(xs:time("10:22:00"))

Ergebnis: 10

Gibt die Integer-Zeile im lokalen Wert des Parameters zurück, die die Minuten repräsentiert.

Beispiel: minutes-from-time(xs:time("10:22:00"))

Ergebnis: 22

Gibt die Integer-Zeile im lokalen Wert des Parameters zurück, die die Sekunden repräsentiert.

Beispiel: seconds-from-time(xs:time("10:22:00"))

Ergebnis: 0

Wenn der Zeitzone-Parameter leer ist, wird das dateTime ohne Zeitzone zurückgegeben.

Sonst wird das dateTime mit Zeitzone zurückgegeben.

Wenn der Zeitzone-Parameter leer ist, wird das Datum ohne Zeitzone zurückgegeben.

Sonst wird das Datum mit Zeitzone zurückgegeben.

Wenn der Zeitzone-Parameter leer ist, wird die Zeit ohne Zeitzone zurückgegeben.

Sonst wird die Zeit mit Zeitzone zurückgegeben.

• fn:name()
• fn:name(nodeset)

• fn:local-name()
• fn:local-name(nodeset)

• fn:namespace-uri()
• fn:namespace-uri(nodeset)

Gibt true zurück, wenn die Sprache des aktuellen Knotens mit der angegebenen Sprache übereinstimmt.

Beispiel: Lang("en") ist true für <p xml:lang="en">...</p>

Beispiel: Lang("de") ist false für <p xml:lang="en">...</p>

• fn:root()
• fn:root(node)

Gibt die Positionen zurück, an denen das searchitem-Element in der Sequenz der Elemente entspricht.

Beispiel: index-of ((15, 40, 25, 40, 10), 40)

Ergebnis: (2, 4)

Beispiel: index-of (("a", "dog", "and", "a", "duck"), "a")

Ergebnis (1, 4)

Beispiel: index-of ((15, 40, 25, 40, 10), 18)

Ergebnis: ()

Gibt eine neue Sequenz zurück, die durch den item-Parameter konstruiert wird - und das Element an der angegebenen position-Position entfernt.

Beispiel: remove(("ab", "cd", "ef"), 0)

Ergebnis: ("ab", "cd", "ef")

Beispiel: remove(("ab", "cd", "ef"), 1)

Ergebnis: ("cd", "ef")

Beispiel: remove(("ab", "cd", "ef"), 4)

Ergebnis: ("ab", "cd", "ef")

Wenn der Parameterwert eine leere Sequenz ist, wird true zurückgegeben, sonst false.

Beispiel: empty(remove(("ab", "cd"), 1))

Ergebnis: false

Wird der Wert des Parameters nicht eine leere Sequenz sein, wird true zurückgegeben, sonst false.

Beispiel: exists(remove(("ab"), 1))

Ergebnis: false

Rückgabe einzigartiger Werte.

Beispiel: distinct-values((1, 2, 3, 1, 2))

Ergebnis: (1, 2, 3)

Rückgabe einer neuen Sequenz, die durch den item-Parameter konstruiert wird - gleichzeitig wird der Wert der inserts-Parameter an der von dem pos-Parameter angegebenen Position eingefügt.

Beispiel: insert-before(("ab", "cd"), 0, "gh")

Ergebnis: ("gh", "ab", "cd")

Beispiel: insert-before(("ab", "cd"), 1, "gh")

Ergebnis: ("gh", "ab", "cd")

Beispiel: insert-before(("ab", "cd"), 2, "gh")

Ergebnis: ("ab", "gh", "cd")

Beispiel: insert-before(("ab", "cd"), 5, "gh")

Ergebnis: ("ab", "cd", "gh")

Rückgabe der umgekehrten Reihenfolge der angegebenen Elemente.

Beispiel: reverse(("ab", "cd", "ef"))

Ergebnis: ("ef", "cd", "ab")

Beispiel: reverse(("ab"))

Ergebnis: ("ab")

Rückgabe der Elementsequenz an der von dem start-Parameter angegebenen Position, die Länge der Sequenz wird durch den len-Parameter bestimmt.

Die Position des ersten Elements ist 1.

Beispiel: subsequence(($item1, $item2, $item3,...), 3)

Ergebnis: ($item3, ...)

Beispiel: subsequence(($item1, $item2, $item3, ...), 2, 2)

Ergebnis: ($item2, $item3)

Gibt den Durchschnitt der Werte der Parameter zurück.

Beispiel: avg((1,2,3))

Ergebnis: 2

Gibt den Parameter zurück, der größer als die anderen Parameter ist.

Beispiel: max((1,2,3))

Ergebnis: 3

Beispiel: max(('a', 'k'))

Ergebnis: 'k'

Gibt den Parameter zurück, der kleiner als die anderen Parameter ist.

Beispiel: min((1,2,3))

Ergebnis: 1

Beispiel: min(('a', 'k'))

Ergebnis: 'a'

• fn:collection()
• fn:collection(string)

Gibt die Indexposition des aktuellen verarbeiteten Knotens zurück.

Beispiel: //book[position()<=3]

Ergebnis: Die ersten drei book-Elemente auswählen

返回在被处理的节点列表中的项目数目。

例子：//book[last()]

结果：选择最后一个 book 元素