@XMLGetName

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

VSPECHXMLNODE XMLN:
Handle des XML-Knotens, dessen Name 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 der Name des XML-Knotens als Text zurückgegeben.
Bei einem ungültigen XML-Node-Handle oder einem Fehler bei der Zeichensatzkonvertierung liefert die @Function @ERROR.

Beispiel: @XMLGetName(XMLN);

XML := "<?xml version=\"1.0\" encoding=\"UTF-8\"?>" +
"<customer>" +
" <name>Example GmbH</name>" +
" <city>Berlin</city>" +
"</customer>";

hXMLD := @XMLParse(XML);
hXMLRoot := @XMLGetRoot(hXMLD);
Name := @XMLGetName(hXMLRoot);
@XMLRelease(hXMLD);

Das Beispiel ermittelt den Namen des Root-Elements. Name enthält anschließend den Wert "customer".