XPath/XQuery-Funktionen: Numerische

www.altova.com Alle erweitern/reduzieren Dieses Kapitel drucken Vorherige Seite Eine Ebene nach oben Nächste Seite

Startseite >  Anhänge > XSLT- und XPath/XQuery-Funktionen > Altova-Erweiterungsfunktionen >

XPath/XQuery-Funktionen: Numerische

Die numerischen Erweiterungsfunktionen von Altova können in XPath- und XQuery-Ausdrücken verwendet werden und stellen zusätzliche Funktionen für die Verarbeitung von Daten zur Verfügung. Die Funktionen in diesem Abschnitt können mit dem XPath 3.0- und XQuery 3.0-Prozessor von Altova verwendet werden. Sie stehen im Zusammenhang mit XPath/XQuery zur Verfügung.

 

Anmerkung zur Benennung von Funktionen und zur Anwendbarkeit der Sprache

Altova-Erweiterungsfunktionen können in XPath/XQuery-Ausdrücken verwendet werden. Dadurch stehen neben den Funktionen in der Standardbibliothek der XPath-, XQuery- und XSLT-Funktionen zusätzliche Funktionen zur Verfügung. Die Altova-Erweiterungsfunktionen befinden sich im Altova-Erweiterungsfunktions-Namespace, http://www.altova.com/xslt-extensions und sind in diesem Abschnitt mit dem Präfix altova:, das als an diesen Namespace gebunden angenommen wird, gekennzeichnet. Beachten Sie, dass manche Funktionen in zukünftigen Versionen Ihres Produkts eventuell nicht mehr unterstützt werden oder dass sich das Verhalten einzelner Funktionen ändern kann. Um zu sehen, welche Altova-Erweiterungsfunktionen unterstützt werden, lesen Sie bitte die Dokumentation zur jeweiligen Release.

 

XPath-Funktionen (in XPath-Ausdrücken in XSLT verwendet):

XP1 XP2 XP3.1

XSLT-Funktionen (in XPath-Ausdrücken in XSLT verwendet):

Xslt1 XSLT2 XSLT3

XQuery-Funktionen (in XQuery-Ausdrücken in XQuery verwendet):

XQ1 XQ3.1

 

 

Funktionen zur automatischen Nummerierung

Click to expand/collapsegenerate-auto-number [altova:]

altova:generate-auto-number(ID als xs:string, StartsWith als xs:double, Increment als xs:double, ResetOnChange als xs:string) als xs:integer     XP1 XP2 XQ1 XP3.1 XQ3.1

Generiert jedes Mal, wenn die Funktion aufgerufen wird, eine Zahl. Die erste Zahl, die beim ersten Aufruf der Funktion generiert wird, wird durch das Argument StartsWith definiert. Bei jedem erneuten Aufruf der Funktion wird eine neue Zahl generiert. Diese Zahl wird durch den im Argument Increment definierten Wert anhand der zuvor generierten Zahl inkrementiert. Auf diese Art erstellt die Funktion altova:generate-auto-number einen Zähler, dessen Name durch das Argument ID definiert wird und der jedes Mal, wenn die Funktion aufgerufen wird, inkrementiert wird. Wenn sich der Wert des Arguments ResetOnChange seit dem vorherigen Funktionsaufruf geändert hat, so wird der Wert der zu generierenden Zahl auf den Wert StartsWith zurückgesetzt. Die Automatische Nummerierung kann auch mit der Funktion altova:reset-auto-number zurückgesetzt werden.

altova:generate-auto-number("ChapterNumber", 1, 1, "SomeString") gibt bei jedem Aufruf der Funktion eine einzige Zahl beginnend mit 1 zurück, die bei jedem Aufruf der Funktion um 1 inkrementiert wird. Solange das vierte Argument in jedem anschließenden Aufruf "SomeString" bleibt, wird die Inkrementierung fortgesetzt. Wenn sich der Wert des vierten Arguments ändert, wird der Zähler (namens ChapterNumber) auf 1 zurückgesetzt. Der Wert von ChapterNumber kann auch folgendermaßen durch Aufruf der Funktion altova:reset-auto-number zurückgesetzt werden: altova:reset-auto-number("ChapterNumber").

 

 

Click to expand/collapsereset-auto-number [altova:]

altova:reset-auto-number(ID als xs:string)     XP1 XP2 XQ1 XP3.1 XQ3.1

Diese Funktion setzt die Zahl des im ID-Argument angegebenen Zählers zur automatischen Nummerierung zurück. Die Zahl wird auf die Zahl zurückgesetzt, die durch das Argument StartsWith der Funktion altova:generate-auto-number, die den im ID-Argument genannten Zähler erstellt hat, definiert ist

altova:reset-auto-number("ChapterNumber") setzt die Zahl des Zählers zur automatischen Nummerierung (ChapterNumber), der durch die Funktion altova:generate-auto-number erstellt wurde, zurück. Die Zahl wird auf den Wert des Arguments StartsWith der Funktion altova:generate-auto-number, die ChapterNumber erstellt hat, zurückgesetzt.

 

 

[ Nach oben ]

 

Numerische Funktionen

Click to expand/collapsehex-string-to-integer [altova:]

altova:hex-string-to-integer(HexString als xs:string) als xs:integer     XP3.1 XQ3.1

Verwendet ein String-Argument, das das Base-16-Äquivalent einer Ganzzahl im Dezimalsystem (Base-10) ist, und gibt die dezimale Ganzzahl zurück.

altova:hex-string-to-integer('1') gibt 1 zurück
altova:hex-string-to-integer('9') gibt 9 zurück
altova:hex-string-to-integer('A') gibt 10 zurück
altova:hex-string-to-integer('B') gibt 11 zurück
altova:hex-string-to-integer('F') gibt 15 zurück
altova:hex-string-to-integer('G') gibt einen Fehler zurück
altova:hex-string-to-integer('10') gibt 16 zurück
altova:hex-string-to-integer('01') gibt 1 zurück
altova:hex-string-to-integer('20') gibt 32 zurück
altova:hex-string-to-integer('21') gibt 33 zurück
altova:hex-string-to-integer('5A') gibt 90 zurück
altova:hex-string-to-integer('USA') gibt einen Fehler zurück

 

 

Click to expand/collapseinteger-to-hex-string [altova:]

altova:integer-to-hex-string(Integer as xs:integer) as xs:string     XP3.1 XQ3.1

Verwendet ein Ganzzahlargument und gibt das Base-16-Äquivalent als String zurück.

altova:integer-to-hex-string(1) gibt 1 zurück
altova:integer-to-hex-string(9) gibt '9' zurück
altova:integer-to-hex-string(10) gibt 'A' zurück
altova:integer-to-hex-string(11) gibt 'B' zurück
altova:integer-to-hex-string(15) gibt 'F' zurück
altova:integer-to-hex-string(16) gibt '10' zurück
altova:integer-to-hex-string(32) gibt '20' zurück
altova:integer-to-hex-string(33) gibt '21' zurück
altova:integer-to-hex-string(90) gibt '5A' zurück

 

 

[ Nach oben ]

 

Funktionen zur Formatierung von Zahlen

Click to expand/collapsegenerate-auto-number [altova:]

altova:generate-auto-number(ID als xs:string, StartsWith als xs:double, Increment als xs:double, ResetOnChange als xs:string) als xs:integer     XP1 XP2 XQ1 XP3.1 XQ3.1

Generiert jedes Mal, wenn die Funktion aufgerufen wird, eine Zahl. Die erste Zahl, die beim ersten Aufruf der Funktion generiert wird, wird durch das Argument StartsWith definiert. Bei jedem erneuten Aufruf der Funktion wird eine neue Zahl generiert. Diese Zahl wird durch den im Argument Increment definierten Wert anhand der zuvor generierten Zahl inkrementiert. Auf diese Art erstellt die Funktion altova:generate-auto-number einen Zähler, dessen Name durch das Argument ID definiert wird und der jedes Mal, wenn die Funktion aufgerufen wird, inkrementiert wird. Wenn sich der Wert des Arguments ResetOnChange seit dem vorherigen Funktionsaufruf geändert hat, so wird der Wert der zu generierenden Zahl auf den Wert StartsWith zurückgesetzt. Die Automatische Nummerierung kann auch mit der Funktion altova:reset-auto-number zurückgesetzt werden.

altova:generate-auto-number("ChapterNumber", 1, 1, "SomeString") gibt bei jedem Aufruf der Funktion eine einzige Zahl beginnend mit 1 zurück, die bei jedem Aufruf der Funktion um 1 inkrementiert wird. Solange das vierte Argument in jedem anschließenden Aufruf "SomeString" bleibt, wird die Inkrementierung fortgesetzt. Wenn sich der Wert des vierten Arguments ändert, wird der Zähler (namens ChapterNumber) auf 1 zurückgesetzt. Der Wert von ChapterNumber kann auch folgendermaßen durch Aufruf der Funktion altova:reset-auto-number zurückgesetzt werden: altova:reset-auto-number("ChapterNumber").

 

 

[ Nach oben ]

 


© 2019 Altova GmbH