@XMLGetChildByName

Diese @Function ermittelt das erste direkte untergeordnete XML-Element mit einem bestimmten Namen.
Optional kann zusätzlich ein Namespace angegeben werden. In diesem Fall muss sowohl der Elementname als auch die Namespace-URI übereinstimmen.
Die Suchparameter werden entsprechend den für das XML-Handle gesetzten Zeichensatz-Flags nach UTF-8 konvertiert.
Die vom übergebenen XML-Node-Handle geerbten Flags werden auf das zurückgegebene XML-Node-Handle übernommen.

VSPECHXMLNODE XMLN:
Handle des XML-Knotens, dessen direkte untergeordnete Elemente durchsucht werden sollen.
XMLN muss ein gültiges VSPECHXMLNODE (XMLN) Handle enthalten, das auf einen XML-Knoten verweist.

TEXT Name:
Name des gesuchten XML-Elements.
Es werden ausschließlich direkte untergeordnete XML-Elemente durchsucht. Andere Knotentypen wie Text- oder Kommentarknoten werden nicht berücksichtigt.

TEXT Namespace (Optional)
Namespace-URI des gesuchten XML-Elements.
Wird kein Namespace angegeben, erfolgt die Suche ausschließlich anhand des Elementnamens.
Wird ein leerer Text ("") als Namespace angegeben, wird ausdrücklich nach einem Element ohne Namespace gesucht.

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

Beispiel: @XMLGetChildByName(XMLN;Name);

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

hXMLD := @XMLParse(XML);
hXMLRoot := @XMLGetRoot(hXMLD);
hXMLName := @XMLGetChildByName(hXMLRoot;"name");
@XMLRelease(hXMLD);

Das Beispiel ermittelt das erste direkte untergeordnete Element mit dem Namen "name".

Beispiel: @XMLGetChildByName(XMLN;Name;Namespace);

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

hXMLD := @XMLParse(XML);
hXMLRoot := @XMLGetRoot(hXMLD);
hXMLName := @XMLGetChildByName(hXMLRoot;"name";"https://example.com/customer");
@XMLRelease(hXMLD);

Das Beispiel ermittelt das erste direkte untergeordnete Element mit dem Namen "name" und der Namespace-URI "https://example.com/customer".