fn:iri-to-uri

(Auszug aus "XSLT 2.0 & XPath 2.0" von Frank Bongers, Kapitel 5.)

A | B | C | D | E | F | G | H | I | J | K | L | M | N | O | P | Q | R | S | T | U | V | W | X | Y | Z

   

Kategorie: Funktionen für URIs

Herkunft: XPath 2.0

Rückgabewert: Ein String xs:string; den in einen gültigen URI-String umgewandelten IRI-String des Eingabearguments.

Aufruf/Argumente:

fn:iri-to-uri($iri-string?)

$eingabesequenz:
Ein String xs:string; ein IRI-String, der in einen gültigen URI-String umzuwandeln ist. Wird der Funktion die leere Sequenz übergeben, so gibt sie einen leeren String zurück.

Verwendungszweck:

Um einen IRI auf einen URI abzubilden, was die Aufgabe der Funktion fn:iri-to-uri() ist, werden zunächst alle im IRI enthaltenen Zeichen nach UTF-8 konvertiert und anschließend diejenigen Zeichen, die innerhalb von URI-Strings verboten sind, durch Maskierung mit Escapesequenzen ersetzt. Die Funktion gibt einen gültigen URI-String vom Typ xs:anyURI zurück.

Erläuterung:
Unter einem IRI (»Internationalized Resource Identifier«) versteht man die verallgemeinerte, internationalisierte Version eines URIs (»Uniform Resource Identifier«), der wiederum die verallgemeinerte Version eines URLs (»Uniform Resource Locator«) darstellt. Der IRI erweitert im Sinne der Internationalisierung das Zeichenrepertoire, das für die Beschreibung einer Ressource gestattet ist, von den für URIs erlaubten ASCII-Zeichen (nach RFC 2396) auf den gesamten Bereich des Universal Character Sets (Unicode/ISO 10646).

Ausführliche Beschreibung bei fn:escape-html-uri()
Eine ausführliche Beschreibung des Maskierungsvorgangs und der zu maskierenden Zeichen finden Sie bei den Erläuterungen zur Funktion fn:escape-html-uri() und bei den Erläuterungen zur Funktion fn:encode-for-uri().

Funktionsdefinition:

XPath 1.0:

Funktion nicht verfügbar

XPath 2.0:

fn:iri-to-uri($iri as xs:string?) as xs:string

   

<< zurück vor >>
Tipp der data2type-Redaktion:
Zum Thema XSLT bieten wir auch folgende Schulungen zur Vertiefung und professionellen Fortbildung an:

Copyright © Galileo Press, Bonn 2008
Für Ihren privaten Gebrauch dürfen Sie die Online-Version ausdrucken.
Ansonsten unterliegt dieses Kapitel aus dem Buch "XSLT 2.0 & XPath 2.0 ― Das umfassende Handbuch" denselben Bestimmungen wie die gebundene Ausgabe: Das Werk einschließlich aller seiner Teile ist urheberrechtlich geschützt. Alle Rechte vorbehalten einschließlich der Vervielfältigung, Übersetzung, Mikroverfilmung sowie Einspeicherung und Verarbeitung in elektronischen Systemen.


Galileo Press, Rheinwerkallee 4, 53227 Bonn