Anzahl der Glieder für Reihenentwicklungen

Die maximale Zahl von Iterationen und damit die Genauigkeit der Reihenentwicklungen lässt sich über den Wert der Variable $intern:max steuern.

In der Regel konvergieren die Reihenglieder gegen 0, und die Reihenbildung wird abgebrochen, wenn das Reihenglied, gerundet mit intern:iround, zu Null wird.

$intern:max kann herabgesetzt werden, um zu Lasten der Genauigkeit eine schnellere Berechnung zu erzielen (ggfs. in Verbindung mit einer Herabsetzung von $intern:round bzw. $intern:iround).

Außerdem sorgt diese Variable für einen Abbruch der Reihenbildung, falls aus irgendeinem Grund (etwa Rundungsungenauigkeiten) der Algorithmus nicht konvergiert.

Stellen für Ergebnis-Rundung

Am Ende der Berechnung werden die Ergebnisse auf diese Anzahl der Stellen gerundet. Default: 16

Der Defaultwert ergibt sich aus der Anforderung, dass jeder standardkonforme XSLT-Prozessor mindestens 18 Digits unterstützen muss, vgl. XML Schema Part 2: Datatypes Second Edition. Da es bei mehrstufigen Berechnungen zu Rundungsfehlern kommen kann, ist die Anzahl der signifikanten Stellen ein Kompromiss. Ich habe mich für 16 Stellen entschieden, weil damit die meisten Tests erfolgreich verlaufen (Details siehe Testergebnisse).

Stellen für interne Ergebnis-Rundung

Am Ende der Berechnung werden die Ergebnisse auf diese Anzahl der Stellen gerundet. Default: 32 (das Doppelte von intern:round)

Hinweis: Intern müssen XSLT-Prozessoren nicht mit dieser Auflösung rechnen, und diese 32 Stellen müssen nicht signifikant oder richtig sein.

Konstante Pi mit 3,14159265358979323846264338327950288419716939937511…

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.25	2011-05-29	Stf
Status: beta initiale Version

Konstante Tau mit 2 * Pi = 6,28318530717958647692528676655900576839433879875021…

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.25	2011-05-29	Stf
Status: beta initiale Version

Konstante e (Eulersche Zahl) mit 2,718281828459045235360287471353…

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.25	2011-05-29	Stf
Status: beta initiale Version

natürlicher Logarithmus von 2 mit 0,69314718055994530941723212145818 (Konstante)

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.25	2011-05-29	Stf
Status: beta initiale Version

natürlicher Logarithmus von 10 mit 2,3025850929940456840179914546844… (Konstante)

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.25	2011-05-29	Stf
Status: beta initiale Version

Wurzel aus 2 mit 1,4142135623730950488… (Konstante)

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.25	2011-05-29	Stf
Status: beta initiale Version

Pi/2 (Konstante)

Revision History
Revision 0.2.35	2011-06-26	Stf
Status: beta initiale Version

berechnet die Fakultät einer natürlichen Zahl

Die Eingabe einer ungültigen Zahl (kleiner 0) führt zum Abbruch (mit Fehlermeldung)

Revision History
Revision 0.2.34	2011-06-19	Stf
Status: beta Umstellung auf intern:fact() und dynamische Typung
Revision 0.2.12	2011-05-21	TM
Status: beta initiale Version

Parameter n as="xs:anyAtomicType"

natürliche Zahl (einschließlich 0)

berechnet die Fakultät einer natürlichen Zahl

Es findet hier keine Typprüfung und keine Gültigkeitsprüfung des Argumentes statt.

Revision History
Revision 0.2.34	2011-06-19	Stf
Status: beta initiale Version

Parameter n as="xs:integer"

natürliche Zahl (einschließlich 0)

berechnet die Potenz basis^exponent

Bei ganzzahligen Exponenten wird die multiplikative Variante mit intern:power() ausgeführt, bei gebrochenen Exponenten wird eine Näherung berechnet.

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.25	2011-05-29	Stf
Status: beta Aufteilung in xsb:pow und intern:pow, Lösung für negative Exponenten
Revision 0.2.12	2011-05-21	TM
Status: beta initiale Version

Parameter basis as="xs:anyAtomicType"

Basis

Parameter exponent as="xs:anyAtomicType"

Exponent

berechnet die Potenz basis^exponent

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.25	2011-05-29	Stf
Status: beta initiale Version

Parameter basis as="xs:anyAtomicType"

Basis

Parameter exponent as="xs:anyAtomicType"

Exponent

berechnet die Potenz basis^exponent für ganzzahlige Exponenten (multiplikative Methode)

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.25	2011-05-29	Stf
Status: beta Berücksichtigung negativer Exponenten
Revision 0.2.12	2011-05-21	TM
Status: beta initiale Version

Parameter basis as="xs:anyAtomicType"

Basis

Parameter exponent as="xs:integer"

Exponent, Ganzzahl

Exponential-Funktion e^exponent

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.12	2011-05-21	TM
Status: beta initiale Version

Parameter exponent as="xs:anyAtomicType"

Exponent der e-Funktion

Exponential-Funktion e^exponent

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.25	2011-05-29	Stf
Status: beta initiale Version

Parameter exponent as="xs:anyAtomicType"

Exponent der e-Funktion

Iterator zur Berechnung der e-Funktion (Reihenbildung)

Die Anzahl der Iterationen resp. Genauigkeit wird von $intern:max und $intern:iround beeinflusst.

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.25	2011-05-29	Stf
Status: beta initiale Version

Parameter exponent as="xs:anyAtomicType"

Exponent der e-Funktion

Parameter vortrag as="xs:anyAtomicType"

Vortrag der Reihenbildung, wird mit 1 initialisiert

Parameter iteration as="xs:integer"

Zähler für Anzahl der Iterationen; wird mit 1 initialisiert

Parameter pow-vortrag as="xs:anyAtomicType"

Vortrag der Potenz, wird mit 1 initialisiert

Parameter fact-vortrag as="xs:integer"

Vortrag der Fakultät, wird mit 1 initialisiert

Exponential-Funktion 10^exponent (Zehnerpotenzen)

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.25	2011-05-29	Stf
Status: beta initiale Version

Parameter exponent as="xs:anyAtomicType"

Exponent

berechnet die Potenz zur Basis 10

Bei ganzzahligen Exponenten wird die multiplikative Variante mit intern:power() ausgeführt, bei gebrochenen Exponenten wird eine Näherung berechnet.

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.25	2011-05-29	Stf
Status: beta initiale Version

Parameter exponent as="xs:anyAtomicType"

Exponent

Sinus-Funktion (Reihenentwicklung)

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.25	2011-05-29	Stf
Status: beta umgeschrieben auf intern:sinus-iterator()
Revision 0.2.12	2011-05-21	TM
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

Eingabewert, als Bogenmaß

berechnet den Sinus

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.25	2011-05-29	Stf
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

Eingabewert, als Bogenmaß

Iterator zur Berechnung des Sinus

Die Anzahl der Iterationen resp. Genauigkeit wird von $intern:max und $intern:iround beeinflusst.

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.25	2011-05-29	Stf
Status: beta initiale Version

Parameter NormalisiertesArgument as="xs:anyAtomicType"

Winkel im Bogenmaß, normalisiert auf den Bereich zwischen - 2 * Pi und 2 * Pi

Parameter vortrag as="xs:anyAtomicType"

Vortrag

Parameter iteration as="xs:integer"

Zähler für Anzahl der Iterationen; wird mit 0 initialisiert

berechnet den Cosinus

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.25	2011-05-29	Stf
Status: beta umgeschrieben auf intern:cosinus-iterator()
Revision 0.2.12	2011-05-21	TM
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

Eingabewert, als Bogenmaß

berechnet den Cosinus

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.25	2011-05-29	Stf
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

Eingabewert, als Bogenmaß

Iterator zur Berechnung des Kosinus

Die Anzahl der Iterationen resp. Genauigkeit wird von $intern:max und $intern:iround beeinflusst.

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.25	2011-05-29	Stf
Status: beta initiale Version

Parameter NormalisiertesArgument as="xs:anyAtomicType"

Winkel im Bogenmaß, normalisiert auf den Bereich zwischen - 2 * Pi und 2 * Pi

Parameter vortrag as="xs:anyAtomicType"

Vortrag

Parameter iteration as="xs:integer"

Zähler für Anzahl der Iterationen; wird mit 0 initialisiert

rechnet Winkel auf den Bereich von - 2 * Pi bis 2 * Pi um

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.25	2011-05-29	Stf
Status: beta initiale Version

Parameter rad as="xs:anyAtomicType"

Winkel im Bogenmaß

berchnet den Tangens

Da als Ergebnis -/+INF ausgegeben werden kann, schlägt in diesen Fällen ein Cast auf ungeeignete Typen (wie xs:decimal) fehl.

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.25	2011-05-29	Stf
Status: alpha initiale Version

Parameter arg as="xs:anyAtomicType"

Eingabewert, als Bogenmaß

berchnet den Tangens

Da als Ergebnis -/+INF ausgegeben werden kann, schlägt in diesen Fällen ein Cast auf ungeeignete Typen (wie xs:decimal) fehl.

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.25	2011-05-29	Stf
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

Eingabewert, als Bogenmaß

berechnet den Cotangens

Da als Ergebnis -/+INF ausgegeben werden kann, schlägt in diesen Fällen ein Cast auf ungeeignete Typen (wie xs:decimal) fehl.

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.25	2011-05-29	Stf
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

Eingabewert, als Bogenmaß

berechnet den Cotangens

Da als Ergebnis -/+INF ausgegeben werden kann, schlägt in diesen Fällen ein Cast auf ungeeignete Typen (wie xs:decimal) fehl.

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.25	2011-05-29	Stf
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

Eingabewert, als Bogenmaß

wandelt Gradmaß in Bogenmaß um

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.12	2011-05-21	TM
Status: beta initiale Version

Parameter deg as="xs:anyAtomicType"

Eingabe im Gradmaß

wandelt Gradmaß in Bogenmaß um

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.12	2011-05-21	TM
Status: beta initiale Version

Parameter deg as="xs:anyAtomicType"

Eingabe im Gradmaß

rechnet Bogenmaß in Gradmaß um

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.12	2011-05-21	TM
Status: beta initiale Version

Parameter rad as="xs:anyAtomicType"

Eingabe im Bogenmaß

rechnet Bogenmaß in Gradmaß um

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.12	2011-05-21	TM
Status: beta initiale Version

Parameter rad as="xs:anyAtomicType"

Eingabe im Bogenmaß

berechnet die Quadratwurzel

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.12	2011-05-21	TM
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

Eingabewert

berechnet die Quadratwurzel, Shortcut für intern:nroot($arg, 2)

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.12	2011-05-21	TM
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

Eingabewert

berechnet die n-te Wurzel (n = Wurzelexponent)

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.12	2011-05-21	TM
Status: beta initiale Version

Parameter wurzelbasis as="xs:anyAtomicType"

Wurzelbasis (Radikand)

Parameter wurzelexponent as="xs:integer"

Wurzelexponent; muss eine natürliche Zahl sein

berechnet die n-te Wurzel (n = Wurzelexponent)

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.25	2011-05-29	Stf
Status: beta initiale Version

Parameter wurzelbasis as="xs:anyAtomicType"

Wurzelbasis (Radikand)

Parameter wurzelexponent as="xs:integer"

Wurzelexponent; muss eine natürliche Zahl sein

iterative Wurzelberechnung nach dem Heron-Verfahren

Die Anzahl der Iterationen resp. Genauigkeit wird von $intern:max und $intern:iround beeinflusst.

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.12	2011-05-21	TM
Status: beta initiale Version

Parameter n as="xs:integer"

Wurzelexponent

Parameter x as="xs:anyAtomicType"

Wurzelbasis (Radikand)

Parameter y as="xs:anyAtomicType"

Vortrag; wird mit 0 initialisiert

Parameter yn as="xs:anyAtomicType"

Vortrag; wird mit Wurzelbasis initialisiert

Parameter iteration as="xs:integer"

Zähler für Anzahl der Iterationen; wird mit 0 initialisiert

berechnet den natürlichen Logarithmus

Da als Ergebnis -INF/INF/NaN ausgegeben werden kann, schlägt in diesen Fällen ein Cast auf ungeeignete Typen (wie xs:decimal) fehl.

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.12	2011-05-21	TM
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

Argument

berechnet den natürlichen Logarithmus (Logarithmus zur Basis e)

Da der Algorithmus von intern:log-iterator besonders gut für Argumente zwischen 1/sqrt(2) und sqrt(2) konvergiert, werden die Argumente in diesen Bereich transformiert. Zuerst wird mit intern:log-m-iterator ein passender Faktor m ermittelt. Das gesuchte Ergebnis ergibt sich über die Beziehung log(x) = 2 * m * log(sqrt(2)) + log((2^ -m) * x).

Da als Ergebnis -INF ausgegeben werden kann (für $arg = 0), schlägt in diesem Fall ein Cast auf ungeeignete Typen (wie xs:decimal) fehl.

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.25	2011-05-29	Stf
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

Argument

ermittelt einen Faktor, um intern:log-iterator in einem Bereich mit günstiger Konvergenz ausführen zu können.

Details siehe intern:log()

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.25	2011-05-29	Stf
Status: beta initiale Version

Parameter x as="xs:anyAtomicType"

Argument der log()-Funktion

Parameter m as="xs:integer"

Vortrag; wird mit 0 initialisiert

Iteration zur Ermittlung des natürlichen Logarithmus

Die Anzahl der Iterationen resp. Genauigkeit wird von $intern:max und $intern:iround beeinflusst.

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.25	2011-05-29	Stf
Status: beta initiale Version

Parameter argm as="xs:anyAtomicType"

ursprüngliches Argument + 1

Parameter argp as="xs:anyAtomicType"

ursprüngliches Argument - 1

Parameter vortrag as="xs:anyAtomicType"

zur Übergabe des Ergebnisses aus den vorherigen Iterationen; wird mit 0 initialisiert

Parameter iteration as="xs:integer"

Zähler für Anzahl der Iterationen; wird mit 0 initialisiert

Parameter n-iteration as="xs:integer"

weiterer Zähler; wird mit 1 initialisiert

berechnet den Logarithmus zur Basis 10 (dekadischer Logarithmus) und rundet das Ergebnis

Da als Ergebnis -INF/INF/NaN ausgegeben werden kann, schlägt in diesen Fällen ein Cast auf ungeeignete Typen (wie xs:decimal) fehl.

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.12	2011-05-21	TM
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

Argument

berechnet den Logarithmus zur Basis 10 (dekadischer Logarithmus)

Da als Ergebnis -INF ausgegeben werden kann (für $arg = 0), schlägt in diesem Fall ein Cast auf ungeeignete Typen (wie xs:decimal) fehl.

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.25	2011-05-29	Stf
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

Argument

berechnet Fibonacci-Zahlen

Revision History
Revision 0.2.25	2011-05-29	Stf
Status: beta Neue Implementierung auf der Grundlage von xsb:fibonacci-sequence
Revision 0.2.12	2011-05-21	TM
Status: beta initiale Version

Parameter n as="xs:integer"

Argument (positive natürliche Zahl)

berechnet Fibonacci-Reihen

Revision History
Revision 0.2.25	2011-05-29	Stf
Status: beta initiale Version

Parameter n as="xs:integer"

Argument (positive natürliche Zahl)

berechnet rekursiv Fibonacci-Reihen, in dem an eine vorhandene Reihe die Summe aus vorletztem und letztem Item angefügt wird.

Die Initalisierung erfolgt in der Regel über xsb:fibonacci-sequence($n as xs:integer), so das hier auf Typechecks verzichtet werden kann (was einer höheren Ausführungsgeschwindigkeit zu gute kommt).

Revision History
Revision 0.2.25	2011-05-29	Stf
Status: beta initiale Version

Parameter n as="xs:integer"

Argument (positive natürliche Zahl), Anzahl der anzuhängenden Fibonacci-Zahlen (- 1, weil die Startsequenz in der Regel (0, 1) ist)

Parameter vortrag as="xs:integer*"

Sequenz von Fibonacci-Zahlen

rundet Zahlen einheitlich für die Ausgabe der mathematischen Funktionen der XSLT-SB

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.25	2011-05-29	Stf
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

zu rundende Zahl

rundet Zahlen für interne Zwecke

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta Umstellung auf dynamische Typung
Revision 0.2.25	2011-05-29	Stf
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

zu rundende Zahl

formatiert einen String für die Fehlerausgabe

Revision History
Revision 0.2.25	2011-05-29	Stf
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

Argument der aufrufenden Funktion

Parameter caller as="xs:string"

Name der aufrufenden Funktion

ermittelt den Arkussinus (im Bogenmaß)

Revision History
Revision 0.2.35	2011-06-26	Stf
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

Argument der xsb:asin()-Funktion

ermittelt den Arkussinus (im Bogenmaß)

Revision History
Revision 0.2.35	2011-06-26	Stf
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

Argument der intern:asin()-Funktion

ermittelt den Arkuskosinus (im Bogenmaß)

Revision History
Revision 0.2.35	2011-06-26	Stf
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

Argument der xsb:acos()-Funktion

ermittelt den Arkuskosinus (im Bogenmaß)

Revision History
Revision 0.2.35	2011-06-26	Stf
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

Argument der intern:acos()-Funktion

ermittelt den Arkustangens (im Bogenmaß)

Problematisch ist das Verhalten bei +/-Pi div 2 mit den "richtigen" Ergebnissen -INF resp. INF. Der XPath-3.0-Entwurf erwartet hier nur "sehr große" resp. "sehr kleine" Zahlen, die jetzt auch geliefert werden (was vielleicht auch den Vorteil, innerhalb von xs:decimal ohne Abbruch weiter rechnen zu können). Allerdings könnte sich dieses Verhalten im endgültigen Standard noch ändern, so dass diese Funktion später noch verändert werden könnte.

Revision History
Revision 0.2.34	2011-06-20	Stf
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

Argument der xsb:atan()-Funktion

ermittelt den Arkustangens (im Bogenmaß)

Revision History
Revision 0.2.35	2011-06-26	Stf
Status: beta Verhalten bei Sonderfällen an XSLT 3.0 angepasst (NaN, INF, -0.0e0)

Revision History
Revision 0.2.34	2011-06-20	Stf
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

Argument der intern:atan()-Funktion

Iteration zur Ermittlung des Arkustangens

Der Algorithmus folgt http://mathworld.wolfram.com/InverseTangent.html, Gleichungen Nr. 44 bis 48.

Revision History
Revision 0.2.34	2011-06-20	Stf
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

Funktionsargument (numerischer Wert)

Parameter an as="xs:anyAtomicType"

zur Übergabe des Ergebnisses aus der vorherigen Iteration, wird mit intern:pow(1 + ($arg * $arg), -0.5 ) initialisiert

Parameter bn as="xs:anyAtomicType"

zur Übergabe des Ergebnisses aus der vorherigen Iteration, wird mit 1 initialisiert

Parameter konstanterDivisor as="xs:anyAtomicType"

zur Optimierung, wird mit intern:sqrt(1 + ($arg * $arg) ) initialisiert

Parameter letztesResultat as="xs:anyAtomicType"

zur Ermittlung des Iteration-Abbruches, wird mit einem beliebigen Wert wie 0 initialisiert.

Parameter iteration as="xs:integer"

Zähler für Anzahl der Iterationen; wird mit 0 initialisiert

berechnet atan2(y, x) im Bogenmaß

Bei Nullwerten wird ein Ergebnis entsprechend dem kommenden XPath-3.0-Standard zurückgegeben.

Revision History
Revision 0.2.34	2011-06-20	Stf
Status: beta initiale Version

Parameter y as="xs:anyAtomicType"

y-Wert (numerisch)

Parameter x as="xs:anyAtomicType"

x-Wert (numerisch)

berechnet atan2(y, x) im Bogenmaß

Bei Nullwerten wird ein Ergebnis entsprechend dem kommenden XPath-3.0-Standard zurückgegeben.

Revision History
Revision 0.2.34	2011-06-20	Stf
Status: beta initiale Version

Parameter y as="xs:anyAtomicType"

y-Wert (numerisch)

Parameter x as="xs:anyAtomicType"

x-Wert (numerisch)

gibt je nach Vorzeichen und Wert des Arguments -1, 0 oder +1 zurück

Im Unterschied zu intern:sgn() wird bei 0 der Wert 0 zurückgegeben: Werte kleiner 0 ergeben -1, Werte gleich 0 ergeben 0 und Werte größer 0 ergeben +1.

Revision History
Revision 0.2.34	2011-06-20	Stf
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

Funktionsargument, numerischer Wert

gibt je nach Vorzeichen des Arguments -1 oder +1 zurück

Im Unterschied zu xsb:sgn() wird bei 0 ein positiver oder negativer Wert zurückgegeben: Werte kleiner 0 und -0.0e0 ergeben -1, Werte größer 0 und (+)0.0e0 ergeben +1.

Revision History
Revision 0.2.34	2011-06-20	Stf
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

Funktionsargument, numerischer Wert

testet, ob ein numerischer Wert NaN ist

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

Funktionsargument

testet, ob ein numerischer Wert INF ist

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

Funktionsargument

testet, ob ein numerischer Wert -INF ist

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

Funktionsargument

testet, ob ein numerischer Wert -0.0e0 ist

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

Funktionsargument

erzeugt NaN mit dem Typ des übergebenen Arguments

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

Funktionsargument

erzeugt INF mit dem Typ des übergebenen Arguments

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

Funktionsargument

erzeugt -INF mit dem Typ des übergebenen Arguments

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

Funktionsargument

erzeugt -0.0e0 mit dem Typ des übergebenen Arguments

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: beta initiale Version

Parameter arg as="xs:anyAtomicType"

Funktionsargument

überprüft, ob ein numerischer Wert innerhalb eines Wertebereiches liegt

Wenn value die Leersequenz, NaN oder kein numerischer Wert ist, wird false() zurückgegeben. Zur Bequemlichkeit wird value auf xs:double gecastet, so dass auch (numerische) Strings verglichen werden können.

Revision History
Revision 0.2.40	2012-01-04	Stf
Status: beta initiale Version

Parameter value as="xs:anyAtomicType?"

zu testender Wert

Parameter minInclusive as="xs:anyAtomicType"

untere Grenze

Parameter maxInclusive as="xs:anyAtomicType"

obere Grenze

berechnet aus einer Folge von numerischen Werten die Stichprobenvarianz

Revision History
Revision 0.2.40	2012-01-04	Stf
Status: beta initiale Version

Parameter sequence_of_numeric_values as="xs:anyAtomicType+"

Eingabewerte, Sequenz von atomaren numerischen Werten

berechnet aus einer Folge von numerischen Werten die Stichprobenvarianz

Der Algorithmus wird unter http://en.wikipedia.org/wiki/Algorithms_for_calculating_variance#Compensated_variant beschrieben.

Revision History
Revision 0.2.40	2012-01-04	Stf
Status: beta initiale Version

Parameter sequence_of_numeric_values as="xs:anyAtomicType+"

Eingabewerte, Sequenz von atomaren numerischen Werten

berechnet die Standardabweichung einer Stichprobe als Quadratwurzel der Varianz

Revision History
Revision 0.2.40	2012-01-04	Stf
Status: beta initiale Version

Parameter sequence_of_numeric_values as="xs:anyAtomicType+"

Eingabewerte, Sequenz von atomaren numerischen Werten

berechnet die Standardabweichung einer Stichprobe als Quadratwurzel der Varianz

Revision History
Revision 0.2.40	2012-01-04	Stf
Status: beta initiale Version

Parameter sequence_of_numeric_values as="xs:anyAtomicType+"

Eingabewerte, Sequenz von atomaren numerischen Werten

linearer Kongruenzgenerator, erzeugt Pseudo-Zufallszahlen

Die erzeugten Werte liegen zwischen 0 und 4294967295.

Die Länge der erzeugten Sequenz ist die Anzahl der Werte in vortrag minus 1 plus length.

Für Details siehe http://de.wikipedia.org/wiki/Kongruenzgenerator#Linearer_Kongruenzgenerator und http://en.wikipedia.org/wiki/Linear_congruential_generator.

Revision History
Revision 0.2.40	2012-01-04	Stf
Status: beta initiale Version

Parameter length as="xs:integer"

Anzahl der neu zu erzeugende Werte

Parameter vortrag as="xs:integer+"

Hilfsparameter für die rekursive Erzeugung der Sequenz. Beim Aufruf der Funktion wird hier der Seed-Wert übergeben, bei weiteren Durchläufen werden neu generierte angehängt. Bei Rückgabe der Seguenz wird der erste Wert (Seed) entfernt.

erzeugt eine Zufallszahl

In die Berechnung der Zufallszahl gehen das aktuelle Datum und die aktuelle Uhrzeit sowie der volatile-Parameter ein.

Auch unabhängig vom Wert von volatile werden bei jedem Aufruf neue zufällige Werte erzeugt, allerdings 1) vermindert ein möglichst zufälliger volatile-Wert die Vorhersagbarkeit des Ergebnisses und 2) verhindert ein wechselnder volatile-Wert bei wiederholten Aufrufen der Funktion, dass der XSLT-Prozessor die unterschiedlichen Rückgabewerte qua Optimierung zu einem Wert vereinheitlicht.

Zum Hintergrund siehe http://blog.expedimentum.com/2012/xsb-random-zufallszahlen-mit-xslt/.

Revision History
Revision 0.2.40	2012-01-04	Stf
Status: beta initiale Version

Parameter volatile as="xs:anyAtomicType"

ein möglichst zufälliger, veränderlicher Wert, der bei jedem Aufruf der Funktion verändert werden sollte

erzeugt eine Sequenz von zufälligen Werten im Bereich von 0 bis 4294967295.

Revision History
Revision 0.2.40	2012-01-04	Stf
Status: beta initiale Version

Parameter length as="xs:integer"

Anzahl der zu erzeugenden Zufallswerte

Parameter volatile as="xs:anyAtomicType"

ein möglichst zufälliger, veränderlicher Wert, der bei jedem Aufruf der Funktion verändert werden sollte, z.B. string(.), count(preceding-sibling::*) o.ä., dabei ist es wichtig, das sich dieser Wert bei jedem Aufruf der Funktion ändert, weniger der Wert oder die Länge. Zum Hintergrund siehe http://blog.expedimentum.com/2012/xsb-random-zufallszahlen-mit-xslt/.

erzeugt eine Zufallszahl im Bereich zwischen 0 und 1

Revision History
Revision 0.2.40	2012-01-04	Stf
Status: beta initiale Version

Parameter volatile as="xs:anyAtomicType"

ein möglichst zufälliger, veränderlicher Wert, der bei jedem Aufruf der Funktion verändert werden sollte, z.B. string(.), count(preceding-sibling::*) o.ä., dabei ist es wichtig, das sich dieser Wert bei jedem Aufruf der Funktion ändert, weniger der Wert oder die Länge. Zum Hintergrund siehe http://blog.expedimentum.com/2012/xsb-random-zufallszahlen-mit-xslt/.

erzeugt eine Sequenz von Pseudo-Zufallszahlen im Bereich zwischen 0 und 1

Revision History
Revision 0.2.40	2012-01-04	Stf
Status: beta initiale Version

Parameter length as="xs:anyAtomicType"

Anzahl der zu erzeugenden Zufallswerte

Parameter volatile as="xs:anyAtomicType"

ein möglichst zufälliger, veränderlicher Wert, der bei jedem Aufruf der Funktion verändert werden sollte, z.B. string(.), count(preceding-sibling::*) o.ä., dabei ist es wichtig, das sich dieser Wert bei jedem Aufruf der Funktion ändert, weniger der Wert oder die Länge. Zum Hintergrund siehe http://blog.expedimentum.com/2012/xsb-random-zufallszahlen-mit-xslt/.

Diese Funktion wandelt Integer- in Hexadezimalzahlen um. Negative Zahlen werden mit einem vorangestellten - (Minus) ausgegeben

Beispiele

• xsb:integer-to-hex(0) ergibt »0«

• xsb:integer-to-hex(10) ergibt »A«

• xsb:integer-to-hex(-10) ergibt »-A«

• xsb:integer-to-hex(-65535) ergibt »-FFFF«

Revision History
Revision 0.2.49	2012-05-19	Stf
Status: beta initiale Version

Parameter input as="xs:integer"

Integer-Zahl

Diese Funktion wandelt Integer- in Hexadezimalzahlen um. Negative Zahlen werden im Zweierkomplement ausgegeben.

Je angefangene vier Bit wird eine Hexadezimalstelle ausgegeben.

Wenn $input nicht mit der gegebenen Anzahl Bits darstellbar ist, wird ein Fehler ausgegeben und die Verarbeitung abgebrochen.

Beispiele

• xsb:integer-to-hex(10, 8) ergibt »0A«

• xsb:integer-to-hex(-24, 8) ergibt »E8«

• xsb:integer-to-hex(-1, 64) ergibt »FFFFFFFFFFFFFFFF«

• xsb:integer-to-hex(128, 8) ergibt einen Fehler

Revision History
Revision 0.2.49	2012-05-19	Stf
Status: beta initiale Version

Parameter input as="xs:integer"

Integer-Zahl

Parameter n as="xs:integer"

Anzahl der Bits für Formatierung

ermittelt das Zweierkomplement

Wenn $input nicht mit der gegebenen Anzahl Bits darstellbar ist, wird ein Fehler ausgegeben und die Verarbeitung abgebrochen.

Beispiele

• xsb:twos-complement(0, 8) ergibt »0«

• xsb:twos-complement(-64, 8) ergibt »192«

• xsb:twos-complement(-64, 64) ergibt »18446744073709551552«

• xsb:twos-complement(128, 8) führt zum Abbruch

• xsb:twos-complement(-129, 8) führt zum Abbruch

Revision History
Revision 0.2.50	2012-05-27	Stf
Status: beta initiale Version

Parameter input as="xs:integer"

Integer-Zahl

Parameter n as="xs:integer"

Anzahl Bits für das Zeierkomplement

ermittelt aus einem Zweierkomplement einen Integer

Wenn $input nicht mit der gegebenen Anzahl Bits darstellbar ist, wird ein Fehler ausgegeben und die Verarbeitung abgebrochen.

Beispiele

• xsb:reverse-twos-complement(0, 8) ergibt »0«

• xsb:reverse-twos-complement(255, 8) ergibt »-1«

• xsb:reverse-twos-complement(192, 8) ergibt »-64«

• xsb:reverse-twos-complement(-1, 8) führt zum Abbruch

• xsb:reverse-twos-complement(192, 4) führt zum Abbruch

Revision History
Revision 0.2.50	2012-05-27	Stf
Status: beta initiale Version

Parameter input as="xs:integer"

Integer-Zahl

Parameter n as="xs:integer"

Anzahl Bits für das Zeierkomplement

wandelt Hexadezimalzahlen im Zweierkomplement in Integer-Zahlen um.

Wenn $input nicht mit der gegebenen Anzahl Bits darstellbar ist, wird ein Fehler ausgegeben und die Verarbeitung abgebrochen.

Eine andere Version dieser Funktion, die negative Zahlen mit Minus-Vorzeichen darstellt, findet sich in numbers.xsl

Beispiele

• xsb:hex-to-integer('0', 8) ergibt »0«

• xsb:hex-to-integer('1', 8) ergibt »1«

• xsb:hex-to-integer('A', 8) ergibt »10«

• xsb:hex-to-integer('FF', 8) ergibt »-1«

• xsb:hex-to-integer('E8', 8) ergibt »-24«

• xsb:hex-to-integer('ffee', 8) führt zum Abbruch

Revision History
Revision 0.2.50	2012-05-27	Stf
Status: beta initiale Version

Parameter input as="xs:string"

eine hexadezimale Zahl (beliebige Folge aus 0-9 und A-F bzw. a-f)

Parameter n as="xs:integer"

Anzahl Bits für das Zeierkomplement

Diese Funktion überprüft, ob der angegebene String eine römische Zahl ist.

Revision History
Revision 0.29	2009-05-03	Stf
Status: beta initiale Version

Parameter input as="xs:string?"

Eingabe (String)

Diese Funktion wandelt eine römische Zahl in einen Integer-Wert um. Ist der eingegebene Wert keine römische Zahl oder leer, ist das Ergebnis 0. Die Funktion ist nicht case-sensitiv, d.h. Groß-/Kleinschreibung der Eingabe spielt keine Rolle.

Revision History
Revision 0.29	2009-05-03	Stf
Status: beta initiale Version

Parameter input as="xs:string?"

römische Zahl (String)

Diese Funktion wandelt eine römische Ziffer (eines der Zeichen I, V, X, L, C, D, M) in einen Integer-Wert um. Ist das eingegebene Zeichen keine römische Ziffer oder leer, ist das Ergebnis 0. Die Funktion ist nicht case-sensitiv, d.h. Groß-/Kleinschreibung der Eingabe spielt keine Rolle.

Revision History
Revision 0.29	2009-05-03	Stf
Status: beta initiale Version

Parameter input as="xs:string?"

römische Ziffer (String)

Diese Funktion erzwingt die Umwandlung eines Strings in xs:decimal.

Ein gültiger String wird mit xs:decimal() umgewandelt. Die Eingabe einer Leersequenz, eines Leerstring oder eines ungültigen Strings ergibt 0.

Revision History
Revision 0.2.34	2011-06-26	Stf
Status: beta saubere Typung auf xs:decimal ergänzt
Revision 0.114	2010-07-17	Stf
Status: beta initiale Version

Parameter input as="xs:string?"

zu castender String

Parameter warn-if-wrong-input as="xs:boolean"

(Boolean) Erzeugt eine Fehlermeldung, wenn der eingegebenen String keine gültige xs:decimal-Zahl ist.

Shortcut für xsb:force-cast-to-decimal($input, true() )

Revision History
Revision 0.114	2010-07-17	Stf
Status: beta initiale Version

Parameter input as="xs:string?"

zu castender String

Diese Funktion erzwingt die Umwandlung eines Strings in xs:integer.

Ein gültiger String wird mit xsb:force-cast-to-integer() umgewandelt. Die Eingabe einer Leersequenz, eines Leerstring oder eines ungültigen Strings ergibt 0.

Revision History
Revision 0.114	2010-07-17	Stf
Status: beta initiale Version

Parameter input as="xs:string?"

zu castender String

Parameter warn-if-wrong-input as="xs:boolean"

(Boolean) Erzeugt eine Fehlermeldung, wenn der eingegebenen String keine gültige xs:integer-Zahl ist.

Shortcut für xsb:force-cast-to-integer($input, true() )

Revision History
Revision 0.114	2010-07-17	Stf
Status: beta initiale Version

Parameter input as="xs:string?"

zu castender String

wandelt Hexadezimal- in Integer-Zahlen um.

Whitespace in der Eingabe wird entfernt, damit Notationen wie »ff d8 d2 e9« ohne weitere Bearbeitung konvertiert werden können.

Die Eingabe eines Leerstrings, einer Leersequenz, eines oder mehrerer ungültiger Zeichen führt zu einer Fehlermeldung.

Eine andere Version dieser Funktion, die negative Zahlen als Zweierkomplement behandelt, findet sich in math.xsl

Beispiele

• xsb:hex-to-integer('0') ergibt »0«

• xsb:hex-to-integer('a') ergibt »10«

• xsb:hex-to-integer('FFFF') ergibt »65535«

• xsb:hex-to-integer('-29a') ergibt »-666«

Revision History
Revision 0.2.50	2012-05-19	Stf
Status: beta initiale Version

Parameter input as="xs:string"

eine hexadezimale Zahl (beliebige Folge aus 0-9 und A-F bzw. a-f), ggfs. mit einem vorangestellten »-« (Minus) für negative Zahlen

gültige Werte: »ALL« > »TRACE« > »DEBUG« > »INFO« > »WARN« > »ERROR« > »FATAL«

Meldungen können einen Level entsprechend den Log4j-Stufen »ALL« > »TRACE« > »DEBUG« > »INFO« > »WARN« > »ERROR« > »FATAL« haben (siehe Template xsb:internals.Error). Dieser Parameter bestimmt, ab welchem Wert Meldungen geloggt (d.h. angezeigt bzw. ausgegeben) werden.

Hilfsvariable, da dieser Wert häufig benötigt wird.

gültige Werte: »ja«, »nein«, »yes«, »no«, »0«, »1« und andere verbale Wahrheitswerte, die xsb:parse-string-to-boolean() versteht

Fehlermeldungen können einen Level entsprechend den Log4j-Stufen »ALL« > »TRACE« > »DEBUG« > »INFO« > »WARN« > »ERROR« > »FATAL« haben (siehe Template xsb:internals.Error). Bei »ERROR« wird die Verarbeitung normalerweise sofort beendet. Ist aber dieser Parameter auf »No« gesetzt, wird die Verarbeitung fortgesetzt, z.B. für Debugging. Bei »FATAL« wird die Verarbeitung in jedem Fall abgebrochen.

Hilfsvariable, da dieser Wert häufig benötigt wird.

gültige Werte: »console«, »file« oder »both«

Loggingmeldungen können via xsl:message auf die Konsole ausgegeben oder in die Ergebnis-Datei geschrieben werden. Auch beides ist möglich. Entsprechend ist als Ziel »console«, »file« oder »both« zu wählen. Bei einer davon abweichenden Eingabe wird nur auf die Konsole geschrieben

Hilfsvariable, da dieser Wert häufig benötigt wird. Bei der Ermittlung dieser Variablen wird außerdem der Parameter internals.logging.output-target auf Gültigkeit geprüft.

Hilfsvariable, da dieser Wert häufig benötigt wird.

gültige Werte: »comment«, »element«, »html«, »text«

Nur bei Ausgabe in Datei: Loggingmeldungen können als HTML, XML-Elemente, Kommentare oder Text in das Ausgabedokument geschrieben werden. HTML eignet sich für die sofortige Anzeige, XML-Elemente für eine spätere maschinelle Auswertung, Kommentare für ad-hoc-Meldungen zur späteren Durchsicht. Text bietet sich an, wenn eine reine Report-Datei generiert werden soll. Ist die Eingabe ungültig, wird als Kommentar ausgegeben.

Hilfsvariable, da dieser Wert häufig benötigt wird. Bei der Ermittlung dieser Variablen wird außerdem der Parameter internals.logging.write-to-file-style auf Gültigkeit geprüft.

Hilfsvariable, da dieser Wert häufig benötigt wird.

Hilfsvariable, da dieser Wert häufig benötigt wird.

Hilfsvariable, da dieser Wert häufig benötigt wird.

Dieses Zeichen wird bei Textausgabe als Zeilenwechsel ausgegeben, per Default 


Dokumentenknoten. Hilfsvariable, um einen Kontext in kontextlose Funktionen und Templates zu transportieren.

Dieses Template ist ein Wrapper für intern:internals.logging.Output für ein einfaches Logging.

Viele Template-Parameter sind mit den Werten der Stylesheet-Parameter oder mit Werten von XPath-Funktionen vorbelegt, um die Benutzung zu vereinfachen.

Revision History
Revision 0.36	2009-08-02	Stf
Status: beta initiale Version

Parameter log-entry.preText as="xs:string?" required="no"

siehe intern:internals.logging.Output#log-entry.preText

Default: leer

Parameter log-entry.ID as="xs:string?" required="no"

siehe intern:internals.logging.Output#log-entry.ID

Default: leer

Parameter log-entry.timeStamp as="xs:dateTime?" required="no"

siehe intern:internals.logging.Output#log-entry.timeStamp

Default: current-dateTime()

Parameter log-entry.processedFile as="xs:string?" required="no"

siehe intern:internals.logging.Output#log-entry.processedFile

Default: document-uri(/)

Parameter log-entry.level as="xs:string?" required="no"

siehe intern:internals.logging.Output#log-entry.level

Default: ALL

Parameter log-entry.text as="xs:string?" required="no"

siehe intern:internals.logging.Output#log-entry.text

Default: leer

Parameter log-entry.category as="xs:string?" required="no"

siehe intern:internals.logging.Output#log-entry.category

Default: leer

Parameter log-entry.postText as="xs:string?" required="no"

siehe intern:internals.logging.Output#log-entry.postText

Default: leer

Parameter log-entry.linebreak-string as="xs:string?" required="no"

siehe intern:internals.logging.Output#log-entry.linebreak-string

Default: $internals.logging.linebreak-string

Parameter log-entry.write-to-console as="xs:boolean" required="no"

siehe intern:internals.logging.Output#log-entry.write-to-console

Default: $_internals.logging.write-to-console

Parameter log-entry.write-to-file as="xs:boolean" required="no"

siehe intern:internals.logging.Output#log-entry.write-to-file

Default: $_internals.logging.write-to-file

Parameter log-entry.write-to-file-as-comment as="xs:boolean" required="no"

siehe intern:internals.logging.Output#log-entry.write-to-file-as-comment

Default: $_internals.logging.write-to-file-as-comment

Parameter log-entry.write-to-file-as-element as="xs:boolean" required="no"

siehe intern:internals.logging.Output#log-entry.write-to-file-as-element

Default: $_internals.logging.write-to-file-as-element

Parameter log-entry.write-to-file-as-html as="xs:boolean" required="no"

siehe intern:internals.logging.Output#log-entry.write-to-file-as-html

Default: $_internals.logging.write-to-file-as-html

Parameter log-entry.write-to-file-as-text as="xs:boolean" required="no"

siehe intern:internals.logging.Output#log-entry.write-to-file-as-text

Default: $_internals.logging.write-to-file-as-text

Parameter log-entry.write-preText as="xs:boolean" required="no"

siehe intern:internals.logging.Output#log-entry.write-preText

Default: false()

Parameter log-entry.write-ID as="xs:boolean" required="no"

siehe intern:internals.logging.Output#log-entry.write-ID

Default: false()

Parameter log-entry.write-timeStamp as="xs:boolean" required="no"

siehe intern:internals.logging.Output#log-entry.write-timeStamp

Default: false()

Parameter log-entry.write-processedFile as="xs:boolean" required="no"

siehe intern:internals.logging.Output#log-entry.write-processedFile

Default: false()

Parameter log-entry.write-level as="xs:boolean" required="no"

siehe intern:internals.logging.Output#log-entry.write-level

Default: true()

Parameter log-entry.write-text as="xs:boolean" required="no"

siehe intern:internals.logging.Output#log-entry.write-text

Default: true()

Parameter log-entry.write-category as="xs:boolean" required="no"

siehe intern:internals.logging.Output#log-entry.write-category

Default: false()

Parameter log-entry.write-postText as="xs:boolean" required="no"

siehe intern:internals.logging.Output#log-entry.write-postText

Default: false()

Dieses Template gibt eine einfache Fehlermeldung aus. Ausgabeart und -ziel werden über die Stylesheet-Parameter bestimmt, wenn keine expliziten Einstellungen übergeben werden.

Es ist ein Wrapper mit sinvollen Vorgabewerten für das Template xsb:internals.Logging.

Außerdem sorgt es dafür, dass bei Fehlern der Stufen ERROR (wenn mit $internals.errors.die-on-critical-errors erlaubt) und FATAL die Verarbeitung des Stylesheets abgebrochen wird.

Revision History
Revision 0.36	2009-08-02	Stf
Status: beta initiale Version

Parameter message as="xs:string?" required="no"

Fehlermeldung

Parameter level as="xs:string?" required="no"

Level der Fehlermeldung. In Anlehnung an Log4j werden per Vorgabe die Stufen »ALL« > »TRACE« > »DEBUG« > »INFO« > »WARN« > »ERROR« > »FATAL« (in aufsteigender Reihenfolge der Dringlichkeit) verwendet.

Default: »ALL«.

Parameter caller as="xs:string?" required="no"

Aufrufende(s) Funktion/Template, z.B. xsb:get-context-as-string()

Parameter show-context as="xs:boolean" required="no"

Falls true(), wird zum Kontextkonten der Kontext angezeigt. Achtung! Das schlägt fehl, wenn es keinen Kontextknoten gibt, z.B. innerhalb von Funktionen oder innerhalb von xsl:for-each-Schleifen über dokumentenexterne Sequenzen. Deshalb gibt es auch ein Template xsb:internals.FunctionError, das dieses Problem umgeht.

Parameter write-to-file as="xs:boolean" required="no"

Falls true(), wird die Ausgabe in die Datei geschrieben. Standardwert: $_internals.logging.write-to-file. In bestimmten Umgebungen, z.B. innerhalb einer Funktion, darf das Template keinen Rückgabewert liefern (siehe deshalb auch xsb:internals.FunctionError). Über diesen Parameter kan der stylesheet-weite Standardwert überschrieben werden.

Dieses Template gibt eine einfache Fehlermeldung aus. Es ist ein Wrapper für xsb:internals.Error, der die Rückgabe von Werten durch das Template unterbindet (was innerhalb von Funktionen in der Regel unerwünscht ist und ggfs. zu Fehlern führen kann).

Achtung! Dadurch werden keine Meldungen (als Kommentar, Text, HTML, XML) in Ausgabedateien geschrieben!

Revision History
Revision 0.59	2009-10-26	Stf
Status: beta initiale Version

Parameter message as="xs:string?" required="no"

Fehlermeldung

Parameter level as="xs:string?" required="no"

Level der Fehlermeldung. In Anlehnung an Log4j werden per Vorgabe die Stufen »ALL« > »TRACE« > »DEBUG« > »INFO« > »WARN« > »ERROR« > »FATAL« (in aufsteigender Reihenfolge der Dringlichkeit) verwendet.

Default: »ALL«.

Parameter caller as="xs:string?" required="no"

Aufrufende(s) Funktion/Template, z.B. xsb:get-context-as-string()

Dieses Template gibt eine Fehlermeldung bei Fehlern in der Logik der XSL-SB aus. Da das Ausführungsverhalten in solchen Situationen nicht vorhersehbar ist, wird die Verarbeitung abgebrochen.

Dieses Template ist ein Wrapper für xsb:internals.Error, der die Rückgabe von Werten durch das Template unterbindet (was innerhalb von Funktionen in der Regel unerwünscht ist und ggfs. zu Fehlern führen kann).

Achtung! Dadurch werden keine Meldungen (als Kommentar, Text, HTML, XML) in Ausgabedateien geschrieben!

Revision History
Revision 0.2.35	2011-06-26	Stf
Status: beta initiale Version

Parameter errorID as="xs:string?" required="yes"

Fehler-Codenummer

Parameter caller as="xs:string?" required="yes"

Aufrufende(s) Funktion/Template, z.B. xsb:get-context-as-string()

Dieses Template erzeugt bei der Ausgabe in eine Datei den Dateikopf, z.B. das Wurzelelement in XML oder Wurzel und Head in HTML.

Genaugenommen verteilt das Template nur entsprechend des Ausgabeformates auf Untertemplates wie intern:internals.logging.MakeHeader.element und intern:internals.logging.MakeHeader.html.

Revision History
Revision 0.139	2011-04-24	Stf
Status: alpha initiale Version

Dieses Template erzeugt bei der Ausgabe in eine Datei den Fuß, z.B. das schließende HTML-Tag oder XML-Element.

Genaugenommen verteilt das Template nur entsprechend des Ausgabeformates auf Untertemplates wie intern:internals.logging.MakeFooter.element und intern:internals.logging.MakeFooter.html.

Hook: kann zum Umformatieren überschrieben werden.

Revision History
Revision 0.139	2011-04-24	Stf
Status: alpha initiale Version

Dieses Template gibt die Werte der Funktion system-property() für die im XSLT-Standard vorgegebenen Parameter vgl. http://www.w3.org/TR/xslt20/#function-system-property aus.

Revision History
Revision 0.36	2009-08-02	Stf
Status: beta initiale Version

Parameter logging-level as="xs:string" required="no"

Zu Beginn der Verarbeitung von internals.xsl (und damit von allen Stylesheets, die internals.xsl einbinden), sind ein paar Parameter für das Logging noch nicht gesetzt. Um trotzdem eine Fehlermeldung zu ermöglichen (beispielsweise bei der Prüfung von Stylesheet-Parametern), wird im diesen Template eine Fehlermeldung unter Verzicht aus betroffene Parameter auf der Konsole ausgegeben.

Das Template ist ein Wrapper für das Template xsb:internals.Logging und hat die selbe Signatur wie xsb:internals.Error.

Achtung! Im Unterschied zu xsb:internals.Error wird bei ERROR in jedem Fall abgebrochen, d.h. der Parameter $internals.errors.die-on-critical-errors beinflusst dieses Template nicht.

Revision History
Revision 0.60	2009-11-01	Stf
Status: beta initiale Version

Parameter message as="xs:string?" required="no"

siehe xsb:internals.Error

Parameter level as="xs:string?" required="no"

siehe xsb:internals.Error

Parameter caller as="xs:string?" required="no"

siehe xsb:internals.Error

Parameter show-context as="xs:boolean" required="no"

siehe xsb:internals.Error

Parameter write-to-file as="xs:boolean" required="no"

siehe xsb:internals.Error

Achtung! Dieser Parameter wird nur empfangen, um die Signatur von xsb:internals.Error zu erhalten, er wird aber nicht ausgewertet, d.h. es wird nie in die Ausgabedatei geschrieben.

Diese Funktion erzeugt aus dem Kontext eines Knotens und dessen Elternknoten einen String in Form eines XPath-Ausdruckes, der diesen Knoten beschreibt. Kann z.B. zur Erläuterung bei Fehlermeldungen eingesetzt werden.

Revision History
Revision 0.36	2009-08-02	Stf
Status: beta initiale Version

Parameter context as="node()?"

Kontextknoten vom Typ node(), kann also vom Typ element(), attribute(), text(), comment() usw. sein

Diese Funktion erzeugt aus dem Kontext eines Knotens einen String in Form eines XPath-Ausdruckes, der diesen Knoten beschreibt. Kann z.B. zur Erläuterung bei Fehlermeldungen eingesetzt werden.

Revision History
Revision 0.36	2009-08-02	Stf
Status: beta initiale Version

Parameter context as="node()?"

Kontextknoten vom Typ node(), kann also vom Typ element(), attribute(), text(), comment() usw. sein

Diese Funktion wandelt eine String-Eingabe in einen Boolean-Wert um. Sie kennt dabei mehr Begriffe als boolean(), z.B. »ja«/»nein«.

Revision History
Revision 0.36	2009-08-02	Stf
Status: beta initiale Version

Parameter input as="xs:string?"

Eingabe (String)

Parameter warn-if-wrong-input as="xs:boolean"

(Boolean) Erzeugt eine Fehlermeldung, wenn der eingegebene String nicht in der Liste der gültigen Werte enthalten ist.

Shortcut für xsb:parse-string-to-boolean($input, true()).

Revision History
Revision 0.36	2009-08-02	Stf
Status: beta initiale Version

Parameter input as="xs:string?"

Eingabe (String)

Erzeugt zu den verbalen Fehlerwerten »ALL« > »TRACE« > »DEBUG« > »INFO« > »WARN« > »ERROR« > »FATAL« einen String, der bei xsb:internals.Error und verwandten Templates als preText verwendet werden kann.

Wird ein ungültiger Wert übergeben, wird der Wert für ALL gewählt.

Revision History
Revision 0.60	2009-11-01	Stf
Status: beta initiale Version

Parameter level as="xs:string?"

Eingabe (String)

Diese Funktion vergleicht zwei beliebig getypte Werte und gibt bei Idendität true() zurück, d.h. der Vergleich ist eine Kombination aus eq und deep-equal() mit höherer Empfindlichkeit und einigen Sonderfällen.

Im Unterschied zum XPath-Operator is können auch atomic values verglichen werden.

Sind die Eingabewerte nicht vom gleichen Typ, ist das Ergebnis false().

Werden -0.0e0 und +0.0e0 verglichen, und unterstützt der jeweilie Typ diesen Unterschied, ist das Ergebnis false().

Werden NaN und NaN verglichen, ist das Ergebnis true().

Werden zwei Leersequenzen verglichen, ist das Ergebnis true().

Revision History
Revision 0.2.37	2011-06-26	Stf
Status: alpha Bugfix für "NaN" unter AltovaXML (bis einschließlich 2011 sp 3) eingefügt
Revision 0.2.34	2011-06-26	Stf
Status: alpha Unterscheidung von -0.0e0 und +0.0e0 eingefügt
Revision 0.139	2011-04-24	Stf
Status: alpha explizite Behandlung für Leersequenzen eingefügt
Revision 0.61	2009-11-16	Stf
Status: beta initiale Version

Parameter input1

Eingabe (ohne Typ)

Parameter input2

Eingabe (ohne Typ)

Diese Funktion ermittelt die Art eines node(), d.h. sie gibt je nach übergebenen Knoten einen der Werte »document-node«, »element«, »attribute«, »text«, »comment«, »processing-instruction« oder »namespace« zurück. Schlagen all Versuche zur Ermittlung fehl, wird der Wert #undefined zurückgegeben (Mir ist kein entsprechender Input-node() bekannt).

Diese Funktion ist eine Implementierung des dm:node-kind-Accessors aus dem XQuery 1.0 and XPath 2.0 Data Model (XDM).

Revision History
Revision 0.61	2009-11-16	Stf
Status: beta initiale Version

Parameter context as="node()?"

Eingabeknoten

Parameter warn-if-wrong-input as="xs:boolean"

Erzeugt eine Fehlermeldung, wenn für den eingegebenen Knoten keine gültige Art ermittelt werden kann. Da die Tests vollständig sind, dürfet dieser Fehler nie auftreten.

Shortcut für xsb:node-kind($context, true())

Revision History
Revision 0.61	2009-11-16	Stf
Status: beta initiale Version

Parameter context as="node()?"

Eingabeknoten (ohne Typ)

Diese Funktion wandelt die verbalen Logging-Level »ALL« > »TRACE« > »DEBUG« > »INFO« > »WARN« > »ERROR« > »FATAL« in korrspondierende Integer-Werte von 0 bis 6 um.

Bei einer ungültigen Eingabe wird »4« (entspricht »WARN«) zurückgegeben.

Revision History
Revision 0.114	2010-07-16	Stf
Status: beta initiale Version

Parameter verbal-logging-level as="xs:string?"

Eingabeknoten (ohne Typ)

Parameter warn-if-wrong-input as="xs:boolean"

Erzeugt eine Fehlermeldung, wenn der eingegebenen String nicht »ALL« > »TRACE« > »DEBUG« > »INFO« > »WARN« > »ERROR« > »FATAL« ist.

Shortcut für xsb:logging-level($verbal-logging-level, true() ).

Revision History
Revision 0.114	2010-07-16	Stf
Status: beta initiale Version

Parameter verbal-logging-level as="xs:string?"

Eingabeknoten (ohne Typ)

Diese Funktion ermittelt aus den übergebenen System-Parameter einen Hashwert, der z.B. für Vergleiche verwendet werden kann

Revision History
Revision 0.141	2011-04-25	Stf
Status: alpha initiale Version

Parameter product-name as="xs:string?"

Wert der entsprechenden System-Eigenschaft (String)

Parameter product-version as="xs:string?"

Wert der entsprechenden System-Eigenschaft (String)

Parameter java-available as="xs:boolean"

Wert der entsprechenden System-Eigenschaft (Boolean)

Parameter is-schema-aware as="xs:boolean"

(Boolean)Wert der entsprechenden System-Eigenschaft (muss ggfs. von String umgewandelt werden, etwa mit xsb:parse-string-to-boolean())

Parameter warn-if-wrong-input as="xs:boolean"

Erzeugt eine Fehlermeldung, wenn der eingegebene String nicht in der Liste der gültigen Werte enthalten ist. (Boolean)

Shortcut für xsb:vendor-hash($product-name, $product-version, $java-available, true()).

Revision History
Revision 0.141	2011-04-25	Stf
Status: alpha initiale Version

Parameter product-name as="xs:string?"

Wert der entsprechenden System-Eigenschaft (String)

Parameter product-version as="xs:string?"

Wert der entsprechenden System-Eigenschaft (String)

Parameter java-available as="xs:boolean"

Wert der entsprechenden System-Eigenschaft (Boolean)

Parameter is-schema-aware as="xs:boolean"

(Boolean)Wert der entsprechenden System-Eigenschaft (muss ggfs. von String umgewandelt werden, etwa mit xsb:parse-string-to-boolean())

Parameter warn-if-wrong-input

Erzeugt eine Fehlermeldung, wenn der eingegebene String nicht in der Liste der gültigen Werte enthalten ist. (Boolean)

Diese Funktion ermittelt – zusammen mit der folgenden – ob Java auf dem ausführenden System zur Verfügung steht.

Revision History
Revision 0.141	2011-04-25	Stf
Status: alpha initiale Version

Diese Funktion ermittelt – zusammen mit der vorhergehenden – ob Java auf dem ausführenden System zur Verfügung steht.

Revision History
Revision 0.141	2011-04-25	Stf
Status: alpha initiale Version

Diese Funktion ermittelt den Vendor-Hash für das aktuelle System.

Revision History
Revision 0.141	2011-04-25	Stf
Status: alpha initiale Version

ermittelt den Typ eines Atomic Values

Dazu wird das Argument mit einer Reihe von instance of … geprüft. Geprüft werden diejenigen Typen, die ein Basic-XSLT-Prozessor laut XSLT-Standard unterstützen muss (vgl. 3.13 Built-in Types). Das sind xs:double, xs:decimal, xs:integer, xs:float, xs:dateTime, xs:date, xs:time, xs:boolean, xs:yearMonthDuration, xs:dayTimeDuration, xs:duration, xs:string, xs:QName, xs:anyURI, xs:gYearMonth, xs:gMonthDay, xs:gYear, xs:gMonth, xs:gDay, xs:base64Binary, xs:hexBinary, xs:untypedAtomic und xs:anyAtomicType.

Achtung: Die XSLT-Prozessor-Hersteller sind nicht verpflichtet, intern den jeweils »richtigen« Typ zu verwenden, $arg kann auch von einem beliebigen Subtyp sein (vgl. hier).

Revision History
Revision 0.2.25	2011-05-29	Stf
Status: alpha initiale Version

Parameter arg as="xs:anyAtomicType"

Eingabeknoten (ohne Typ)

Parameter warn-if-wrong-input as="xs:boolean"

Erzeugt eine Fehlermeldung, wenn der Typ nicht ermittelt werden kann. Da die Tests vollständig sind und zumindest xs:untypedAtomic immer das Ergebnis sein sollte, dürfet dieser Fehler nie auftreten.

Shortcut für xsb:type-annotation($arg, true() )

Revision History
Revision 0.2.25	2011-05-29	Stf
Status: alpha initiale Version

Parameter arg as="xs:anyAtomicType"

Eingabeknoten (ohne Typ)

wandelt einen Atomic Value beliebigen Types in einen Atomic Value mit Typ entsprechend dem Parameter "as" um

Unterstützt werden diejenigen Typen, die ein Basic-XSLT-Prozessor laut XSLT-Standard unterstützen muss (vgl. 3.13 Built-in Types): xs:double, xs:decimal, xs:integer, xs:float, xs:dateTime, xs:date, xs:time, xs:boolean, xs:yearMonthDuration, xs:dayTimeDuration, xs:duration, xs:string, xs:QName, xs:anyURI, xs:gYearMonth, xs:gMonthDay, xs:gYear, xs:gMonth, xs:gDay, xs:base64Binary, xs:hexBinary, xs:untypedAtomic mit Ausnahme von xs:anyAtomicType (weil ein Cast dahin nicht möglich ist).

Laut Standard kann nicht auf xs:QName gecastet werden, da dieser Cast ein statisches String Literal erfordert und deshalb nicht mit dynamisch zu evaluierenden Variablen bzw. Parametern funktioniert. Details siehe im XPath-Standard, Punkt 4.a., und err:XPTY0004.

Revision History
Revision 0.2.25	2011-05-29	Stf
Status: alpha initiale Version

Parameter arg as="xs:anyAtomicType"

Eingabeknoten (ohne Typ)

Parameter as as="xs:string"

Typ, auf den gecastet werden soll

Verarbeitet Eingabe und Vergleichswert mit normalize-space() und lower-case() und vergleicht dann Eingabe und Vergleichswert. Dadurch werden kleine Differenzen ignoriert.

Revision History
Revision 0.53	2009-10-25	Stf
Status: beta initiale Version

Parameter input as="xs:string?"

Eingabe (String)

Parameter compare-to as="xs:string?"

Vergleichswert (String)

gibt einen übergebenen Standardwert aus, wenn der übergeben String leer ist oder nur Whitespace enthält, sonst den String selbst

Wenn der übergebene Standardwert eine Leersequenz ist, wird ein Leerstring zurückgegeben.

Revision History
Revision 0.53	2009-10-25	Stf
Status: beta initiale Version

Parameter input as="xs:string?"

Eingabe (String)

Parameter default as="xs:string?"

Standardwert (String)

entfernt führenden Whitespace

Revision History
Revision 0.2.48	2012-05-18	Stf
Status: beta auf fn:replace() umgeschrieben
Revision 0.53	2009-10-25	Stf
Status: beta initiale Version

Parameter input as="xs:string?"

Eingabe (String)

entfernt Whitespace am Ende eines Strigs

Revision History
Revision 0.2.48	2012-05-18	Stf
Status: beta auf fn:replace() umgeschrieben
Revision 0.53	2009-10-25	Stf
Status: beta initiale Version

Parameter input as="xs:string?"

Eingabe (String)

entfernt Whitespace am Anfang und am Ende. Im Unterschied zu normalize-space() wird Whitespace in der Mitte nicht berücksichtigt.

Revision History
Revision 0.53	2009-10-25	Stf
Status: beta initiale Version

Parameter input as="xs:string?"

Eingabe (String)

ersetzt mehrfache Zeilenwechsel durch einen einzelnen Zeilenwechsel. Im Unterschied zu normalize-space() wird ein Zeilenwechsel aber erhalten.

rekursiver Algorithmus: die Funktion ruft sich solange selbst auf, bis keine mehrfachen Zeilenwechsel in der Eingabe vorhanden sind.

Da die Eingabe sinnvoll eine Leersequenz sein kann, ist die Rückgabe einer Leersequenze erlaubt.

Revision History
Revision 0.53	2009-10-25	Stf
Status: beta initiale Version

Parameter input as="xs:string?"

Eingabe (String)

Diese Funktion überprüft, ob in einer Leerzeichen-getrennten Liste ein bestimmter Eintrag vorhanden ist.

Die Eingabe eines Leerstrings oder einer Leersequenz als Parameter list ergibt false().

Die Eingabe eines Leerstrings oder einer Leersequenz als Parameter item ergibt false().

Revision History
Revision 0.2.48	2012-05-18	Stf
Status: beta neben Leerzeichen ist jetzt auch anderer Whitespace zum Trennen der String-Token erlaubt
Revision 0.69	2009-12-05	Stf
Status: beta initiale Version

Parameter list as="xs:string?"

Whitespace-getrennte Liste von String-Token

Parameter item as="xs:string?"

String-Token, auf dessen Existenz getestet werden soll

Diese Funktion fügt vor und nach dem zu testenden String die übergebenen Strings ein, wenn der zu testende String nicht leer ist.

Mit dieser Funktion wird die Erzeugung von bedingten Texten vereinfacht, bspw. das Einfügen von Kommata oder Doppelpunkten nach einem Text.

Revision History
Revision 0.96	2010-06-27	Stf
Status: beta initiale Version

Parameter tested-string as="xs:string?"

getesteter String

Parameter string-before as="xs:string?"

String, der vor dem getesteten String eingefügt werden soll

Parameter string-after as="xs:string?"

String, der nach dem getesteten String eingefügt werden soll

wandelt einen eingegebenen String in eine xs:ID um, indem verbotene Zeichen ersetzt werden

Revision History
Revision 0.124	2010-10-10	Stf
Status: beta initiale Version

Parameter input as="xs:string?"

Eingabe (String)

Shortcut für xsb:sort($input-sequence, 'ascending')

Revision History
Revision 0.2.47	2012-05-14	Stf
Status: beta initiale Version

Parameter input-sequence as="xs:anyAtomicType*"

Sequenz von atomic values

sortiert atomic values

Die Implementierung folgt dem XSLT Beispiel aus dem 2.0-Standard.

Die Werte in der Sequenz müssen mit lt vergleichbar sein. Insbesondere scheitert das Sortieren von gemischten Sequenzen aus Strings und Zahlen.

Revision History
Revision 0.2.47	2012-05-14	Stf
Status: beta initiale Version

Parameter input-sequence as="xs:anyAtomicType*"

Sequenz von atomic values

Parameter order as="xs:string"

»ascending«/»descending«

escapet Steuerzeichen in regulären Ausdrücken mit »\«

Ist input die Leersequenz, wird der Leerstring zurückgegeben.

Beispiele

• xsb:escape-for-regex('Jan.') ergibt »Jan\.«

• xsb:escape-for-regex('^1.200$') ergibt »\^1\.200\$«

Revision History
Revision 0.2.47	2012-05-15	Stf
Status: alpha initiale Version

Parameter input as="xs:string?"

String, der escapet werden soll

escapet Steuerzeichen in Ersetzungstexten für fn:replace() (»\« und »$«) mit »\«

Ist input die Leersequenz, wird der Leerstring zurückgegeben.

Beispiele

• xsb:escape-for-replacement('$0') ergibt »\$0«

• xsb:escape-for-replacement('\1.200$') ergibt »\\1.200\$«

Revision History
Revision 0.2.48	2012-05-17	Stf
Status: alpha initiale Version

Parameter input as="xs:string?"

String, der escapet werden soll

zählt das Vorkommen eines Suchstrings in einem String

Sind string oder regex Leerstring oder die Leersequenz, wird 0 zurückgegeben.

Beispiele

• xsb:count-matches('abc def abc', 'def') ergibt »1«

• xsb:count-matches('abc def abc', 'abc') ergibt »2«

• xsb:count-matches('abc', '[ab]') ergibt »2«

• xsb:count-matches('abc', '[ab]+') ergibt »1«

• xsb:count-matches('Aa', 'a', '') ergibt »1«

• xsb:count-matches('Aa', 'a', 'i') ergibt »2«

Revision History
Revision 0.2.47	2012-05-15	Stf
Status: beta initiale Version

Parameter string as="xs:string?"

String, in dem gezählt wird

Parameter regex as="xs:string?"

regulärer Ausdruck, nach dem in string gesucht wird

Parameter flags as="xs:string?"

flags analog zum flags-Parameter von fn:matches() (siehe XQuery 1.0 and XPath 2.0 Functions and Operators (Second Edition), 7.6.6.1 Flags)

Shortcut für xsb:count-matches($string, $regex, '')

Revision History
Revision 0.2.47	2012-05-16	Stf
Status: beta initiale Version

Parameter string as="xs:string?"

String, in dem gezählt wird

Parameter regex as="xs:string?"

regulärer Ausdruck, nach dem in string gesucht wird

führt wiederholtes paarweises Suchen und Ersetzen über einen String aus

Diese Funktion vereinfachte wiederholtes Suchen und Ersetzen über den selben String. Für jeden Wert aus der pattern-Sequenz wird ein fn:replace() mit dem korrespondierenden Wert (selbe Position) aus der replacement-Sequenz über den Eingabe-String ausgeführt. Sind in der replacement-Sequenz weniger Werte als in der pattern-Sequenz, werden (analog zu fn:translate()) die Fundstellen der »überzähligen« Pattern gelöscht.

Ist input der Leerstring oder die Leersequenz, wird ein Leerstring zurückgegeben.

Ist pattern der Leerstring oder die Leersequenz, wird input unverändert zurückgegeben (Ausnahme: Wenn input die Leersequenz ist, wird ein Leerstring zurückgegeben).

Ist replacement der Leerstring, wird jeder Treffer von pattern in input gelöscht.

Achtung: eine Leersequenz innerhalb der pattern- oder replacement-Sequenz »verschwindet« aus der Sequenz, d.h. die nachfolgenden Werte rücken eine Position nach vorn. Das wird in der Regel nicht der gewünschte Effekt sein!

Beispiele

• xsb:replace('Affe Bär Elefant', ('Affe', 'Elefant') , ('monkey', 'elephant') ) ergibt »monkey Bär elephant«

• xsb:replace('Affe Bär Elefant', ('Affe', 'Elefant') , ('monkey', '') ) ergibt »monkey Bär «

• xsb:replace('Affe Bär Elefant', ('Affe', 'Elefant') , ('monkey') ) ergibt »monkey Bär «

• xsb:replace('Affe Bär Elefant Löwe', ('Affe', 'Bär', 'Elefant', 'Löwe') , ('monkey', '', 'elephant', 'lion') ) ergibt »monkey elephant lion«

• xsb:replace('Affe Bär Elefant', ('Affe', '', 'Elefant') , ('monkey', '', 'elephant') ) ergibt »monkey Bär elephant« (Leerstring in der pattern-Sequenz lässt Eingabe unverändert)

• xsb:replace('Affe Bär Elefant', ('Affe', (), 'Elefant') , ('monkey', '', 'elephant') ) ergibt »monkey Bär « (Leersequenz in der pattern-Sequenz »verschwindet«, dadurch wird Elefant durch den Leerstring ersetzt)

• xsb:replace('Affe Bär Elefant', ('Affe', 'Bär', 'Elefant') , ('monkey', (), 'elephant') ) ergibt »monkey elephant « (Leersequenz in der replacement-Sequenz »verschwindet«, dadurch wird Bär durch elephant ersetzt, und Elefant wird gelöscht.)

Revision History
Revision 0.2.47	2012-05-15	Stf
Status: beta initiale Version

Parameter input as="xs:string?"

String, in dem ersetzt wird

Parameter pattern as="xs:string*"

Sequenz von regulären Ausdrücken, nach denen in input gesucht wird

Parameter replacement as="xs:string*"

Sequenz von Ersetzungstexten

Parameter flags as="xs:string?"

flags analog zum flags-Parameter von fn:replace() (siehe XQuery 1.0 and XPath 2.0 Functions and Operators (Second Edition), 7.6.6.1 Flags)

Shortcut für xsb:replace($input, $pattern, $replacement, '')

Revision History
Revision 0.2.47	2012-05-15	Stf
Status: beta initiale Version

Parameter input as="xs:string?"

String, in dem ersetzt wird

Parameter pattern as="xs:string*"

Sequenz von regulären Ausdrücken, nach denen in input gesucht wird

Parameter replacement as="xs:string*"

Sequenz von Ersetzungstexten

ermittelt die Position des ersten Auftretens von pattern in string

Ist string oder pattern der Leerstring oder die Leersequenz, wird 0 zurückgegeben.

Beispiele

• xsb:index-of-first-match('ab', 'a') ergibt »1«

• xsb:index-of-first-match('ab', 'b') ergibt »2«

• xsb:index-of-first-match('ab', 'c') ergibt »0«

• xsb:index-of-first-match('ABC', 'b', '') ergibt »0«

• xsb:index-of-first-match('ABC', 'b', 'i') ergibt »2«

Revision History
Revision 0.2.47	2012-05-16	Stf
Status: beta initiale Version

Parameter input as="xs:string?"

String, in dem gesucht wird

Parameter pattern as="xs:string?"

regulärer Ausdruck, nach dem in input gesucht wird

Parameter flags as="xs:string?"

flags analog zum flags-Parameter von fn:tokenize() (siehe XQuery 1.0 and XPath 2.0 Functions and Operators (Second Edition), 7.6.6.1 Flags)

Shortcut für xsb:index-of-first-match($input, $pattern, '')

Revision History
Revision 0.2.47	2012-05-16	Stf
Status: beta initiale Version

Parameter input as="xs:string?"

String, in dem gesucht wird

Parameter pattern as="xs:string?"

regulärer Ausdruck, nach dem in input gesucht wird