XML_REMOVE_CHILDREN

Script-Funktion: Entfernt alle Unterelemente eines XML-Elements.

Syntax

XML_REMOVE_CHILDREN (Element)

Syntaxteil	Beschreibung/Format
Element	Verweis auf das Element, dessen Unterelement gelöscht wird. Format: Script-Literal oder Script-Variable

Rückgabewert
'0' - Alle Unterelemente des angegebenen Elements wurden erfolgreich gelöscht.

Das Script-Element löscht alle untergeordneten Elemente eines bestimmten Elements innerhalb des geöffneten XML-Dokuments. Der Verweis auf das Element muss angegeben werden. Das Script-Element gibt den Wert '0' zurück, nachdem das Unterelement erfolgreich gelöscht wurde.

Hinweise:

• Die XML-Struktur kopiert nur die XML-Struktur, die im  Speicher abgelegt ist. Das Script-Element hat keinen Einfluss auf die Registerkarte "Dokumentation".
• Verwenden Sie die Script-Funktion XML_OPEN, um das XML-Dokument zu öffnen. Weitere Informationen finden Sie unter XML_OPEN.

Beispiel

Das folgende Beispiel öffnet die Registerkarte Strukturierte Dokumentation als XML-Dokument. Anschließend wird das erste Element angegeben und alle seine Unterelemente werden gelöscht. Wenn das Löschen erfolgreich war, wird eine entsprechende Meldung in das Aktivierungslog geschrieben.

:SET &XMLDOCU#=XML_OPEN(DOCU,,"@Details")

: IF &XMLDOCU# <> ""
:SET &FIRST# = XML_GET_FIRST_CHILD(&XMLDOCU#)
:SET &RET# = XML_REMOVE_CHILDREN(&FIRST#)

:IF &RET# = 0
:P 'Unterelement erfolgreich gelöscht.'
: ENDIF

:ENDIF

:XML_CLOSE &XMLDOCU#

Siehe auch: