Function DE Version 10.01

@XMLNodeListGetElements

XML

Syntax

@XMLNodeListGetElements(XMLNL);

Beschreibung

Diese @Function ermittelt die Anzahl der in einer XML-NodeList enthaltenen Knoten.

VSPECHXMLNODELIST
XMLNL:
Handle der XML-NodeList, deren Anzahl an Elementen ermittelt werden soll.
XMLNL muss ein gültiges VSPECHXMLNODELIST (XMLNL) Handle enthalten.

Return-Wert:
Bei erfolgreicher Ausführung liefert die @Function die Anzahl der in der NodeList enthaltenen Knoten als numerischen Wert zurück.
Ist das übergebene XML-NodeList-Handle ungültig oder wurde die NodeList bereits freigegeben, liefert die @Function @ERROR.


Beispiel: @XMLNodeListGetElements(XMLNL);

XML := "<?xml version=\"1.0\" encoding=\"UTF-8\"?>" +
"<customers>" +
" <customer id=\"1\" />" +
" <customer id=\"2\" />" +
"</customers>";
hXMLD := @XMLParse(XML);
hXMLRoot := @XMLGetRoot(hXMLD);
hXMLNL := @XMLSelectNodes(hXMLRoot;"customer");
Elements := @XMLNodeListGetElements(hXMLNL);
@XMLNodeListRelease(hXMLNL);
@XMLRelease(hXMLD);

Das Beispiel ermittelt die Anzahl der in der NodeList enthaltenen "<customer>"-Elemente. Elements enthält anschließend den Wert 2.