Function DE Version 10.01

@XMLGetNamespace

XML

Syntax

@XMLGetNamespace(XMLN);

Beschreibung

Diese @Function ermittelt den Namespace eines XML-Knotens.
Das übergebene Handle muss ein gültiges VSPECHXMLNODE (XMLN) Handle enthalten. Ist dem Knoten ein Namespace zugeordnet, wird dessen Namespace-URI als Text zurückgegeben.
Ist für das XML-Handle eine Zeichensatzkonvertierung aktiviert, wird der zurückgegebene Namespace entsprechend konvertiert.

VSPECHXMLNODE XMLN:
Handle des XML-Knotens, dessen Namespace ermittelt werden soll.
XMLN muss ein gültiges VSPECHXMLNODE (XMLN) Handle enthalten, das auf einen XML-Knoten verweist.

Return-Wert:
Bei erfolgreicher Ausführung wird die Namespace-URI des XML-Knotens als Text zurückgegeben.
Ist dem XML-Knoten kein Namespace zugeordnet, wird ein leerer Text zurückgegeben.
Bei einem ungültigen XML-Node-Handle oder einem Fehler bei der Zeichensatzkonvertierung liefert die @Function @ERROR.

Beispiel: @XMLGetNamespace(XMLN);

XML := "<?xml version=\"1.0\" encoding=\"UTF-8\"?>" +
"<customer xmlns=\"https://example.com/customer\">" +
" <name>Example GmbH</name>" +
"</customer>";

hXMLD := @XMLParse(XML);
hXMLRoot := @XMLGetRoot(hXMLD);
Namespace := @XMLGetNamespace(hXMLRoot);
@XMLRelease(hXMLD);

Das Beispiel ermittelt den Namespace des Root-Elements. Namespace enthält anschließend den Wert "https://example.com/customer".