@XMLGetFirstChild
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".
