]> Dateien und Dateisystem Dieses Stylesheet enthält Funktionen rund um das Dateisystem. Ein Großteil der Funktionen führt Formatchecks auf Strings aus und extrahiert Teile aus Strings, um den Umgang mit externe Dateien zu vereinfachen. Da der von XSLT präferierte Typ xs:anyURI recht unspezifisch ist, wird dabei auf URLs nach RFC 1808 zurückgegriffen. Einige Wertebereiche und Funktionsergebnisse sind nicht absolut konform zu RFC 1808 oder auch RFC 3986 (URIs), um den praktischen Nutzen zu erhöhen. So ist beispielsweise laut RFC 1808 die Tilde (~) kein gültiges Zeichen in URLs, sie wurde hier aber zugelassen. 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;/files.xsl Dokumentation: &doc-Base-Directory;/files.html Test-Stylesheet: &XSL-Base-Directory;/files_tests.xsl Test-Dokumentation: &doc-Base-Directory;/files_tests.html XSLT-SB: &XSL-Base-Directory;/ Google Code: http://code.google.com/p/xslt-sb/ 0.2.41 2012-02-04 Stf Umstellung auf stylesheet-interne Tabelle und dadurch mehr Mediatypes und Extensions 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.120 2010-07-26 Stf <xsl:value-of/> gegen <xsl:sequence/> ausgetauscht 0.80 2010-03-28 Stf Diverse Ergänzungen und BugFixes, v.a. um xsb:file-exist() zum Laufen zu bringen 0.74 2010-03-01 Stf Neudesign mit Java und Entity References, Saxon-spezifische Funktionen entfernt 0.53 2009-10-25 Stf Umstellung auf Namespaces xsb: und intern: 0.52 2009-10-13 Stf Anpassungen an unterschiedliche Saxon-Versionen 0.50 2009-10-11 Stf Start mit Testroutinen 0.36 2009-08-02 Stf Umstellung der Lizenz auf CC-BY 3.0 0.28 2009-05-03 Stf erste Version mit Dokumentation String, der als URL interpretiert wird. Diese Funktion überprüft, ob die angegebene URL absolut ist. Das Ergebnis ist ein Wahrheitswert (xs:boolean, true() oder false()). Die Eingabe eines Leerstringes gibt false() zurück. Die Eingabe einer ungültigen URL gibt false() zurück. 0.74 2010-01-03 Stf Status: beta initiale Version String, der als URL interpretiert wird. Diese Funktion überprüft, ob die angegebene URL relativ ist. Das Ergebnis ist ein Wahrheitswert (xs:boolean, true() oder false()). Die Eingabe eines Leerstringes gibt true() zurück. Die Eingabe einer ungültigen URL gibt false() zurück. 0.74 2010-01-03 Stf Status: beta initiale Version String, der als URL interpretiert wird. Diese Funktion überprüft, ob die angegebene URL ausschließlich einen Netzwerk-Server referenziert, d.h. keinen lokalen Teil hat. Das Ergebnis ist ein Wahrheitswert (xs:boolean, true() oder false()). Die Eingabe eines Leerstringes gibt false() zurück. Die Eingabe einer ungültigen URL gibt false() zurück. 0.74 2010-01-03 Stf Status: beta initiale Version String, der als URL interpretiert wird. Diese Funktion überprüft, ob die angegebene URL einen Authority-Teil hat. Das Ergebnis ist ein Wahrheitswert (xs:boolean, true() oder false()). Die Eingabe eines Leerstringes gibt false() zurück. Die Eingabe einer ungültigen URL gibt false() zurück. 0.75 2010-03-18 Stf Status: beta initiale Version String, der als URL interpretiert wird. Diese Funktion überprüft, ob die angegebene URL ein Pfad ist, d.h. es wird durch die URL keine Datei referenziert. Kriterium ist, ob die URL entweder (a) einen Netzwerk-Server referenziert oder (b) mit "/", "/." oder "/.." endet oder (c) "." oder ".." ist. Das Ergebnis ist ein Wahrheitswert (xs:boolean, true() oder false()). Die Eingabe eines Leerstringes gibt false() zurück. Die Eingabe einer ungültigen URL gibt false() zurück. 0.74 2010-01-03 Stf Status: beta initiale Version String, der als URL interpretiert wird. Diese Funktion überprüft, ob die angegebene URL nur aus Pfad-Shortcuts ("/", ".", "..") besteht. Das Ergebnis ist ein Wahrheitswert (xs:boolean, true() oder false()). Die Eingabe eines Leerstringes gibt false() zurück. Die Eingabe einer ungültigen URL gibt false() zurück. 0.74 2010-01-03 Stf Status: beta initiale Version String, der als URL interpretiert wird. Diese Funktion überprüft, ob der eingegebene String eine gültige URL gemäß RFC 1808 ist. Das Ergebnis ist ein Wahrheitswert (xs:boolean, true() oder false()). Die Eingabe eines Leerstringes gibt true() zurück. Die Eingabe einer ungültigen URL gibt false() zurück. Abweichend von den zugrundeliegenden Standards RFC 1808 und RFC 3986 werden bestimmte URLs nicht als gültig angesehen ("scheme" steht für URL-Schema): scheme: scheme:/ 0.80 2010-03-27 Stf Status: beta Ausschluss standardkonformer, aber wenig hilfreicher URLs wie "scheme:" 0.74 2010-01-03 Stf Status: beta initiale Version String, der als URL interpretiert wird. Diese Funktion überprüft, ob die angegebene URL einen Query-Teil hat. Das Ergebnis ist ein Wahrheitswert (xs:boolean, true() oder false()). Die Eingabe eines Leerstringes gibt false() zurück. Die Eingabe einer ungültigen URL gibt false() zurück. 0.74 2010-01-03 Stf Status: beta initiale Version String, der als URL interpretiert wird. Diese Funktion gibt den Query-Teil von einer URL zurück. Die Eingabe eines Leerstringes gibt einen Leerstring zurück. Die Eingabe einer ungültigen URL gibt einen Leerstring zurück. 0.74 2010-01-03 Stf Status: beta initiale Version String, der als URL interpretiert wird. Diese Funktion überprüft, ob die angegebene URL einen Fragment-Teil (eine Referenz auf einen Dokumenten-Teil nach einem Hash-Zeichen #) hat. Das Ergebnis ist ein Wahrheitswert (xs:boolean, true() oder false()). Die Eingabe eines Leerstringes gibt false() zurück. Die Eingabe einer ungültigen URL gibt false() zurück. 0.74 2010-01-03 Stf Status: beta initiale Version String, der als URL interpretiert wird. Diese Funktion gibt den Fragment-Teil von einer URL zurück. Die Eingabe eines Leerstringes gibt einen Leerstring zurück. Die Eingabe einer ungültigen URL gibt einen Leerstring zurück. 0.74 2010-01-03 Stf Status: beta initiale Version String, der als URL interpretiert wird. Diese Funktion gibt den scheme-Teil von einer absoluten URL zurück. Die Eingabe eines Leerstringes gibt einen Leerstring zurück. Die Eingabe einer ungültigen URL gibt einen Leerstring zurück. 0.75 2010-03-07 Stf Status: beta initiale Version String, der als URL interpretiert wird. Diese Funktion entfernt Query- und Fragment-Teil von einer URL. Die Eingabe eines Leerstringes gibt einen Leerstring zurück. Die Eingabe einer Leersequenz gibt einen Leerstring zurück. Die Eingabe einer ungültigen URL gibt einen Leerstring zurück. 0.74 2010-01-03 Stf Status: beta initiale Version String, der als URL interpretiert wird. Diese Funktion gibt Dateinamen und Dateierweiterung aus einer URL zurück. Die Eingabe einer Server-URL oder eines Pfades gibt einen Leerstring zurück. Die Eingabe eines Leerstringes gibt einen Leerstring zurück. Die Eingabe einer ungültigen URL gibt einen Leerstring zurück. 0.74 2010-01-03 Stf Status: beta initiale Version String, der als URL interpretiert wird. Diese Funktion ermittelt eine eventuelle Dateierweiterung aus einer URL. Da die Interpretation von Dateinamenserweiterungen sehr DOS/Windows-spezifisch ist, wird deren Interpretation nachvollzogen. Beispielsweise ist ".txt" (nur Erweiterung "txt") ein gültiger Dateiname für eine Textdatei. Die Eingabe einer Server-URL oder eines Pfades gibt einen Leerstring zurück. Die Eingabe eines Leerstringes gibt einen Leerstring zurück. Die Eingabe einer ungültigen URL gibt einen Leerstring zurück. Die Eingabe einer URL mit einem Dateinamen, der nur aus Punkt+Erweiterung besteht, gibt die Erweiterung zurück. 0.85 2010-04-10 Stf Status: beta Dateiname = Dateierweiterung berücksichtigt. 0.74 2010-01-03 Stf Status: beta initiale Version String, der als URL interpretiert wird. Diese Funktion überprüft, ob die angegebene URL einen Dateinamen beinhaltet, und ob dieser Dateiname eine Dateierweiterung hat. Das Ergebnis ist ein Wahrheitswert (xs:boolean, true() oder false()). Da die Interpretation von Dateinamenserweiterungen sehr DOS/Windows-spezifisch ist, wird deren Interpretation nachvollzogen. Beispielsweise ist ".txt" (nur Erweiterung "txt") ein gültiger Dateiname für eine Textdatei. Die Eingabe eines Leerstringes gibt false() zurück. Die Eingabe einer ungültigen URL gibt false() zurück. 0.85 2010-04-10 Stf Status: beta Dateiname = Dateierweiterung berücksichtigt. 0.83 2010-04-03 Stf Status: beta initiale Version String, der als URL interpretiert wird. Diese Funktion ermittelt einen Dateinamen ohne eventuelle Dateierweiterung aus einer URL. Die Eingabe einer Server-URL oder eines Pfades gibt einen Leerstring zurück. Die Eingabe eines Leerstringes gibt einen Leerstring zurück. Die Eingabe eines Dateinamens, der nur aus Punkt+Dateierweiterung besteht (z.B. ".txt"), gibt einen Leerstring zurück. Die Eingabe einer ungültigen URL gibt einen Leerstring zurück. 0.74 2010-01-03 Stf Status: beta initiale Version String, der als URL interpretiert wird. Diese Funktion ermittelt einen Pfad ohne eventuelle Dateinamen und Dateierweiterung aus einer URL. Die Eingabe eines Leerstringes gibt einen Leerstring zurück. Die Eingabe einer ungültigen URL gibt einen Leerstring zurück. 0.74 2010-01-03 Stf Status: beta initiale Version Absoluter Pfad zur zu überprüfenden Datei. Diese Funktion überprüft, ob die angegebene Datei lokal vorhanden ist. Das Ergebnis ist ein Wahrheitswert (xs:boolean, true() oder false()). Es werden nur lokale Dateien mit absoluten URLs getestet. Dies impliziert, dass auch keine URLs mit einer authority bearbeitet werden können (hier hält sich die Funktion an die Vorgaben von Java), d.h. bei absoluten URLs, die nicht mit dem Protokoll-Teil file:/ oder file:/// beginnen, wird false() zurückgegeben. Der Wertebereich für gültige Parameter wurde auf den kleinsten gemeinsamen Nenner der zu Grunde liegenden Funktionen eingegrenzt. Achtung! Diese Funktion erfordert bei Ausführung Java oder Saxon-spezifische Erweiterungen. 0.74 2010-01-03 Stf Status: alpha initiale Version xsb:file-exists(absoluteURL) ERROR Eingabe "" ist keine absolute URL. Für relative URLs kann xsb:file-exists(relativeURL, baseURL) verwendet werden. xsb:file-exists(absoluteURL) ERROR Eingabe "" hat einen authority-Part (d.h. verweist auf eine Ressource im Internet). Es können nur lokale Dateien getestet werden. xsb:file-exists(absoluteURL) ERROR Eingabe "" ist nicht im "file"-Schema. Es können nur lokale Dateien getestet werden, d.h. die absolute URL der Datei muss mit "file:" beginnen. relativer Pfad zur zu überprüfenden Datei. Basis für den relativen Pfad. Diese Funktion überprüft, ob die angegebene Datei lokal vorhanden ist. Das Ergebnis ist ein Wahrheitswert (xs:boolean, true() oder false()). Die relative URL wird gegenüber der Basis aufgelöst. Es werden nur lokale Dateien getestet, d.h. beginnt die Basis nicht mit dem Protokoll file: oder verweist auf eine Ressource im Internet (= hat einen authority-Teil), wird false() zurückgegeben. Achtung! Diese Funktion erfordert bei Ausführung Java oder Saxon-spezifische Erweiterungen. 0.74 2010-01-03 Stf Status: alpha initiale Version xsb:file-exists(relativeURL, baseURL) ERROR Eingabe "" für realtiveURL ist keine relative URL. xsb:file-exists(relativeURL, baseURL) ERROR Eingabe einer baseURL erforderlich. xsb:file-exists(relativeURL, baseURL) ERROR Eingabe "" für baseURL ist keine absolute URL. xsb:file-exists(relativeURL, baseURL) FATAL Logischer Fehler in Auswertungslogik. Absoluter Pfad zur zu überprüfenden Datei. Diese Funktion überprüft, ob die angegebene Datei lokal vorhanden ist. Das Ergebnis ist ein Wahrheitswert (xs:boolean, true() oder false()). Es werden nur lokale Dateien mit absoluten URLs getestet. Achtung! Diese Funktion erfordert bei Ausführung Java. 0.74 2010-01-03 Stf Status: alpha initiale Version Pfad zur zu überprüfenden Datei Diese Funktion überprüft, ob die angegebene Datei lokal vorhanden ist. Das Ergebnis ist ein Wahrheitswert (xs:boolean, true() oder false()). Achtung! Diese Funktion erfordert bei Ausführung die Saxon-spezifische Erweiterung saxon:last-modified(), die in Saxon-PE und Saxon-EE (aber nicht in Saxon-HE) ab Version 9.2 vorhanden sind. 0.74 2010-01-03 Stf Status: alpha initiale Version Pfad zur zu überprüfenden Datei Diese Funktion überprüft, ob die angegebene Datei lokal vorhanden ist. Das Ergebnis ist ein Wahrheitswert (xs:boolean, true() oder false()). Achtung! Diese Funktion erfordert bei Ausführung die Saxon-spezifische Erweiterung saxon:file-last-modified(), die in Saxon-B und Saxon-SA bis einschließlich Version 9.1 vorhanden sind. 0.74 2010-01-03 Stf Status: alpha initiale Version Pfad zur zu überprüfenden Datei Diese Funktion wird aufgerufen, wenn weder Java noch Saxon-spezifische Funktionen vorhanden sind. In diesem Fall wird die Stylesheet-Verarbeitung abgebrochen, z.B. bei Saxon-B 8.9, Saxon-HE 9.2 und Intel 2.0. 0.74 2010-01-03 Stf Status: alpha initiale Version intern:file-exists() FATAL Keine Möglichkeit zur Ermittlung, ob eine Datei existiert (Vendor-Hash: "") URL, aus dessen file extension der Mediatype ermittelt werden soll. Soll eine Warnung ausgegeben werden, wenn der Mediatyp nicht ermittelt werden kann? Diese Funktion ermittelt aus der Dateierweiterung den Mediatyp (auch MIME-Typ genannt). Die Eingabe eines Leerstringes gibt einen Leerstring zurück. Die Eingabe einer ungültigen URL gibt einen Leerstring zurück. Die Eingabe einer ungültigen Dateierweiterung gibt einen Leerstring und – in Abhängigkeit von warn-if-wrong-input – ggfs. eine Warnung zurück. 0.2.41 2012-02-04 Stf Status: beta Umstellung auf stylesheet-interne Tabelle und dadurch mehr Mediatypes und Extensions 0.90 2010-04-23 Stf Status: beta initiale Version Media-Type für "" konnte nicht ermittelt werden, Leerstring zurückgegeben. WARN xsb:mediatype-from-url application/andrew-insetezapplication/excelxlsapplication/mac-binhex40hqxapplication/mac-compactprocptapplication/mathml+xmlmathmlapplication/msworddocapplication/octet-streambinapplication/odaodaapplication/oggoggapplication/pdfpdfapplication/pgppgpapplication/pgp-encryptedpgpapplication/pgp-keyspgpapplication/pgp-signaturesigapplication/postscriptpsapplication/postscriptaiapplication/postscriptepsapplication/rdf+xmlrdfapplication/rdfrdfapplication/rtfrtfapplication/smilsmilapplication/smilsmiapplication/srgsgramapplication/srgs+xmlgrxmlapplication/vnd.mifmifapplication/vnd.mozilla.xul+xmlxulapplication/vnd.ms-excelxlsapplication/vnd.ms-powerpointpptapplication/vnd.ms-projectmppapplication/vnd.ms-tneftnefapplication/vnd.rn-realmediarmapplication/vnd.wap.wbxmlwbxmlapplication/vnd.wap.wmlcwmlcapplication/vnd.wap.wmlscriptcwmlscapplication/voicexml+xmlvxmlapplication/x-arj-compressedarjapplication/x-bcpiobcpioapplication/x-cdlinkvcdapplication/x-chess-pgnpgnapplication/x-compressZapplication/x-cpiocpioapplication/x-cshcshapplication/x-debian-packagedebapplication/x-directordcrapplication/x-directordirapplication/x-directordxrapplication/x-dtbncx+xmlncxapplication/x-dvidviapplication/x-futuresplashsplapplication/x-gtargtarapplication/x-gunzipgzapplication/x-gzipgzapplication/x-hdfhdfapplication/x-javascriptjsapplication/x-koanskpapplication/x-koanskdapplication/x-koansktapplication/x-koanskmapplication/x-latexlatexapplication/x-mifmifapplication/x-msdos-programexeapplication/x-netcdfcdfapplication/x-netcdfncapplication/x-netcdfncapplication/x-perlplapplication/x-perlpmapplication/x-pythonpyapplication/x-rar-compressedrarapplication/x-shshapplication/x-sharsharapplication/x-shockwave-flashswfapplication/x-stuffitsitapplication/x-sv4cpiosv4cpioapplication/x-sv4crcsv4crcapplication/x-tartarapplication/x-tar-gztgzapplication/x-tcltclapplication/x-textexapplication/x-texinfotexiapplication/x-texinfotexinfoapplication/x-trofftapplication/x-trofftrapplication/x-trofftroffapplication/x-troff-manmanapplication/x-troff-memeapplication/x-troff-msmsapplication/x-ustarustarapplication/x-wais-sourcesrcapplication/x-zip-compressedzipapplication/xhtml+xmlxhtmlapplication/xhtml+xmlxhtapplication/xhtmlxhtmlapplication/xhtmlxhtapplication/xmlxmlapplication/xml-dtddtdapplication/xslt+xmlxsltapplication/xsltxsltapplication/zipzipaudio/basicauaudio/midimidaudio/midimidiaudio/mpegmpaaudio/ulawauaudio/ulawsndaudio/x-aiffaifaudio/x-mpegurlm3uaudio/x-pn-realaudioramaudio/x-wavwavchemical/x-pdbpdbchemical/x-xyzxyzimage/bmpbmpimage/cgmcgmimage/g3faxfaximage/gifgifimage/iefiefimage/jpegjpgimage/jpegjpegimage/pngpngimage/svg+xmlsvgimage/tifftifimage/tifftiffimage/vnd.djvudjvuimage/vnd.wap.wbmpwbmpimage/x-cmu-rasterrasimage/x-iconicoimage/x-portable-anymappnmimage/x-portable-bitmappbmimage/x-portable-graymappgmimage/x-portable-pixmapppmimage/x-rgbrgbimage/x-xbitmapxbmimage/x-xpixmapxpmimage/x-xwindowdumpxwdmodel/igesigsmodel/meshmshmodel/vrmlvrmltext/calendaricstext/csscsstext/htmlhtmltext/plaintxttext/richtextrtxtext/rtfrtftext/sgmlsgmltext/tab-separated-valuestsvtext/vnd.wap.wmlwmltext/vnd.wap.wmlscriptwmlstext/x-setextetxtext/xmlxmlvideo/dldlvideo/fliflivideo/glglvideo/mpegmpgvideo/quicktimemovvideo/vnd.mpegurlmxuvideo/x-msvideoavivideo/x-sgi-moviemoviex-conference/x-cooltalkicex-world/x-vrmlvrml URL, aus dessen file extension der Mediatype ermittelt werden soll. Shortcut für xsb:mediatype-from-url($URLwithFileExtension, true()). 0.90 2010-04-23 Stf Status: beta initiale Version Mediatype, aus dem die Dateierweiterung ermittelt werden soll. Soll eine Warnung ausgegeben werden, wenn die Dateierweiterung nicht ermittelt werden kann? Diese Funktion ermittelt aus dem Mediatyp (auch MIME-Typ genannt) die Dateierweiterung. Die Eingabe eines Leerstringes gibt einen Leerstring zurück. Die Eingabe eines ungültigen Mediatypes gibt einen Leerstring und – in Abhängigkeit von warn-if-wrong-input – ggfs. eine Warnung zurück. 0.2.41 2012-02-04 Stf Status: beta initiale Version Dateierweiterung für "" konnte nicht ermittelt werden, Leerstring zurückgegeben. WARN xsb:file-extension-from-mediatype Mediatype, aus dem die Dateierweiterung ermittelt werden soll. Shortcut für xsb:file-extension-from-mediatype($mediatype, true()). 0.2.41 2012-02-04 Stf Status: beta initiale Version