&cr;"> ]> Strings und Texte Dieses Stylesheet enthält Funktionen für Strings und Texte. Da für Testroutinen Funktionen und Templates aus internals.xsl benötigt werden, wird dieses Stylesheet in strings_tests.xsl getestet. Autor: Stefan Krause Homepage: http://www.expedimentum.org/ Lizenz (duale Lizenzierung): Dieses Stylesheet und die dazugehörige Dokumentation sind unter einer Creative Commons-Lizenz (CC-BY 3.0) lizenziert. Die Weiternutzung ist bei Namensnennung erlaubt. Dieses Stylesheet und die dazugehörige Dokumentation sind unter der sogenannten Expat License (einer GPL-kompatiblen MIT License) lizensiert. Es darf – als Ganzes oder auszugweise – unter Beibehaltung der Copyright-Notiz kopiert, verändert, veröffentlicht und verbreitet werden. Die Copyright-Notiz steht im Quelltext des Stylesheets und auf der Startseite der Dokumentation. Stylesheet: &XSL-Base-Directory;/strings.xsl Dokumentation: &doc-Base-Directory;/strings.html Test-Stylesheet: &XSL-Base-Directory;/strings_tests.xsl Test-Dokumentation: &doc-Base-Directory;/strings_tests.html XSLT-SB: &XSL-Base-Directory;/ Google Code: http://code.google.com/p/xslt-sb/ 0.2.50 2012-05-27 Stf neue Funktionen: xsb:fill-left(), xsb:fill-right() 0.2.49 2012-05-18 Stf neue Funktionen: xsb:escape-for-replacement(); überarbeitet: xsb:trim-left(), xsb:trim-right(); erweiter: xsb:listed() 0.2.47 2012-05-15 Stf neue Funktionen: xsb:sort(), xsb:escape-for-regex(), xsb:count-matches() 0.2.0 2011-05-14 Stf erste veröffentlichte Version 0.129 2011-02-27 Stf Erweiterung der Lizenz auf Expath/MIT license 0.53 2009-10-25 Stf Umstellung auf Namespaces xsb: und intern: 0.36 2009-08-02 Stf initiale Version Eingabe (String) Vergleichswert (String) Verarbeitet Eingabe und Vergleichswert mit normalize-space() und lower-case() und vergleicht dann Eingabe und Vergleichswert. Dadurch werden kleine Differenzen ignoriert. 0.53 2009-10-25 Stf Status: beta initiale Version Eingabe (String) Standardwert (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. 0.53 2009-10-25 Stf Status: beta initiale Version Eingabe (String) entfernt führenden Whitespace 0.2.48 2012-05-18 Stf Status: beta auf fn:replace() umgeschrieben 0.53 2009-10-25 Stf Status: beta initiale Version Eingabe (String) entfernt Whitespace am Ende eines Strigs 0.2.48 2012-05-18 Stf Status: beta auf fn:replace() umgeschrieben 0.53 2009-10-25 Stf Status: beta initiale Version Eingabe (String) entfernt Whitespace am Anfang und am Ende. Im Unterschied zu normalize-space() wird Whitespace in der Mitte nicht berücksichtigt. 0.53 2009-10-25 Stf Status: beta initiale Version 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. 0.53 2009-10-25 Stf Status: beta initiale Version Whitespace-getrennte Liste von String-Token String-Token, auf dessen Existenz getestet werden soll 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(). 0.2.48 2012-05-18 Stf Status: beta neben Leerzeichen ist jetzt auch anderer Whitespace zum Trennen der String-Token erlaubt 0.69 2009-12-05 Stf Status: beta initiale Version getesteter String String, der vor dem getesteten String eingefügt werden soll String, der nach dem getesteten String eingefügt 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. 0.96 2010-06-27 Stf Status: beta initiale Version Eingabe (String) wandelt einen eingegebenen String in eine xs:ID um, indem verbotene Zeichen ersetzt werden 0.124 2010-10-10 Stf Status: beta initiale Version Sequenz von atomic values Shortcut für xsb:sort($input-sequence, 'ascending') 0.2.47 2012-05-14 Stf Status: beta initiale Version Sequenz von atomic values »ascending«/»descending« 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. 0.2.47 2012-05-14 Stf Status: beta initiale Version String, der escapet werden soll escapet Steuerzeichen in regulären Ausdrücken mit »\« Ist input die Leersequenz, wird der Leerstring zurückgegeben. xsb:escape-for-regex('Jan.') ergibt »Jan\.« xsb:escape-for-regex('^1.200$') ergibt »\^1\.200\$« 0.2.47 2012-05-15 Stf Status: alpha initiale Version String, der escapet werden soll escapet Steuerzeichen in Ersetzungstexten für fn:replace() (»\« und »$«) mit »\« Ist input die Leersequenz, wird der Leerstring zurückgegeben. xsb:escape-for-replacement('$0') ergibt »\$0« xsb:escape-for-replacement('\1.200$') ergibt »\\1.200\$« 0.2.48 2012-05-17 Stf Status: alpha initiale Version String, in dem gezählt wird regulärer Ausdruck, nach dem in string gesucht wird 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) zählt das Vorkommen eines Suchstrings in einem String Sind string oder regex Leerstring oder die Leersequenz, wird 0 zurückgegeben. 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« 0.2.47 2012-05-15 Stf Status: beta initiale Version 0 String, in dem gezählt wird regulärer Ausdruck, nach dem in string gesucht wird Shortcut für xsb:count-matches($string, $regex, '') 0.2.47 2012-05-16 Stf Status: beta initiale Version String, in dem ersetzt wird Sequenz von regulären Ausdrücken, nach denen in input gesucht wird Sequenz von Ersetzungstexten 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) 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! 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.) 0.2.47 2012-05-15 Stf Status: beta initiale Version String, in dem ersetzt wird Sequenz von regulären Ausdrücken, nach denen in input gesucht wird Sequenz von Ersetzungstexten Shortcut für xsb:replace($input, $pattern, $replacement, '') 0.2.47 2012-05-15 Stf Status: beta initiale Version String, in dem gesucht wird regulärer Ausdruck, nach dem in input gesucht wird 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) ermittelt die Position des ersten Auftretens von pattern in string Ist string oder pattern der Leerstring oder die Leersequenz, wird 0 zurückgegeben. 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« 0.2.47 2012-05-16 Stf Status: beta initiale Version 0 String, in dem gesucht wird regulärer Ausdruck, nach dem in input gesucht wird Shortcut für xsb:index-of-first-match($input, $pattern, '') 0.2.47 2012-05-16 Stf Status: beta initiale Version String, der aufgefüllt werden soll Zeichen, mit dem aufgefüllt werden soll Anzahl Zeichen, auf die aufgefüllt werden soll füllt $input links bis zur Länge $length mit dem Zeichen $fill-with auf Bei einem Leerstring oder einer Leersequenz als $input wird vollständig mit $fill-with aufgefüllt. Bei einem Leerstring oder einer Leersequenz als $fill-with wird $input unverändert zurückgegeben. Ist $input länger als $fill-with, wird $input unverändert zurückgegeben. xsb:fill-left('X', '-', 4) ergibt »---X« xsb:fill-left('', '-', 4) ergibt »----« xsb:fill-left('X', '', 4) ergibt »X« xsb:fill-left('sieben', '-', 4) ergibt »sieben« 0.2.50 2012-05-27 Stf Status: beta initiale Version String, der aufgefüllt werden soll Zeichen, mit dem aufgefüllt werden soll Anzahl Zeichen, auf die aufgefüllt werden soll füllt $input rechts bis zur Länge $length mit dem Zeichen $fill-with auf Bei einem Leerstring oder einer Leersequenz als $input wird vollständig mit $fill-with aufgefüllt. Bei einem Leerstring oder einer Leersequenz als $fill-with wird $input unverändert zurückgegeben. Ist $input länger als $fill-with, wird $input unverändert zurückgegeben. xsb:fill-right('X', '-', 4) ergibt »X---« xsb:fill-right('', '-', 4) ergibt »----« xsb:fill-right('X', '', 4) ergibt »X« xsb:fill-right('sieben', '-', 4) ergibt »sieben« 0.2.50 2012-05-27 Stf Status: beta initiale Version