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. |
|
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: