Function DE Version 10.01

@XMLGetPrefix

XML

Syntax

@XMLGetPrefix(XMLN);

Beschreibung

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

VSPECHXMLNODE XMLN:
Handle des XML-Knotens, dessen Namespace-Präfix 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 das Namespace-Präfix des XML-Knotens als Text zurückgegeben.
Ist dem XML-Knoten kein Namespace-Präfix 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: @XMLGetPrefix(XMLN);

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

hXMLD := @XMLParse(XML);
hXMLRoot := @XMLGetRoot(hXMLD);
Prefix := @XMLGetPrefix(hXMLRoot);
@XMLRelease(hXMLD);

Das Beispiel ermittelt das Namespace-Präfix des Root-Elements. Prefix enthält anschließend den Wert "c".