Function DE Version 10.01

@XMLGetNextSibling

XML

Syntax

@XMLGetNextSibling(XMLN);

Beschreibung

Diese @Function ermittelt das nächste XML-Sibling-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 nächstes Sibling-Element ermittelt werden soll.
XMLN muss ein gültiges VSPECHXMLNODE (XMLN) Handle enthalten, das auf einen XML-Knoten verweist.

Return-Wert:
Wird ein nachfolgendes Sibling-Element gefunden, liefert die @Function ein VSPECHXMLNODE (XMLN) Handle auf das nächste XML-Sibling-Element zurück.
Existiert kein weiteres Sibling-Element oder ist das übergebene XML-Node-Handle ungültig, liefert die @Function @ERROR.

Beispiel: @XMLGetNextSibling(XMLN);

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

hXMLD := @XMLParse(XML);
hXMLRoot := @XMLGetRoot(hXMLD);
hXMLName := @XMLGetFirstChild(hXMLRoot);
hXMLCity := @XMLGetNextSibling(hXMLName);
Name := @XMLGetName(hXMLCity);
@XMLRelease(hXMLD);

Das Beispiel ermittelt zunächst das erste untergeordnete XML-Element und anschließend dessen nächstes Sibling-Element. Name enthält danach den Wert "city".