fn:doc-available

(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: Assoziation und Auffindung von Nodes und Ressourcen

Herkunft: XPath 2.0

Rückgabewert: Ein boolescher Wert, true oder false.

Aufruf/Argumente:

fn:doc-available($uri-string?)

$uri-string:
Ein String xs:string, der lexikalisch einem gültigen URI-String xs:anyURI entsprechen muss.

Verwendungszweck:

Die Funktion fn:doc-available() prüft, ob der ihr übergebene String einem URI entspricht, der auf eine existierende und einbindbare Ressource zeigt. Die Funktion liefert daher nur in dem Fall den Wert true zurück, dass der URI-String auf einen Dokumentknoten zeigt. Ist dies nicht der Fall, so lautet der Rückgabewert false.

Wird der Funktion ein String übergeben, der kein gültiger URI-String vom Typ xs:anyURI sein kann, so wird der Fehler »Invalid argument to fn:doc or fn:doc-available« gemeldet (err:FODC0005).

Beispiel – Vorabprüfung der Einbindung einer externen Ressource:

if fn:document-available('mein_doc.xml')
   then fn:doc('mein_doc.xml')

Die Einbindung der externen Ressource findet nur dann statt, wenn sie existiert und erfasst werden kann – dies wird durch fn:doc-available() sichergestellt.

Funktionsdefinition:

XPath 1.0:

Funktion nicht verfügbar

XPath 2.0:

fn:doc-available($uri as xs:string?) as xs:boolean

   

<< zurück

vor >>