Function DE Version 10.01

@XMLGetFirstChild

XML

Syntax

@XMLGetFirstChild(XMLN);

Beschreibung

Diese @Function ermittelt das erste direkt untergeordnete XML-Element eines XML-Knotens.
Es werden ausschließlich XML-Elemente berücksichtigt. Andere Knotentypen wie Text-, Kommentar- oder CDATA-Knoten werden übersprungen.
Die vom übergebenen XML-Node-Handle geerbten Flags werden auf das zurückgegebene XML-Node-Handle übernommen.

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

Return-Wert:
Wird ein untergeordnetes XML-Element gefunden, liefert die @Function ein VSPECHXMLNODE (XMLN) Handle auf das erste direkte untergeordnete Element zurück.
Besitzt der XML-Knoten kein untergeordnetes XML-Element oder ist das übergebene XML-Node-Handle ungültig, liefert die @Function @ERROR.

Beispiel: @XMLGetFirstChild(XMLN);

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

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

Das Beispiel ermittelt das erste untergeordnete XML-Element des Root-Elements. Name enthält anschließend den Wert "name".