XML_REMOVE_CHILDREN

Verwenden Sie die Script-Funktion XML_REMOVE_CHILDREN, um alle untergeordneten Elemente eines bestimmten offenen Elements innerhalb des XML-Dokuments zu löschen. XML_REMOVE_CHILDREN gibt den Wert 0 zurück, sobald die Unterelemente erfolgreich gelöscht wurden.

Wichtig! Die XML-Struktur wird nur im Speicher geändert. Die Änderungen von XML_REMOVE_CHILDREN werden nicht auf der strukturierten Dokumentationsseite angezeigt.

Tipp: Verwenden Sie die Script-Funktion XML_OPEN, um das XML-Dokument zu öffnen. Weitere Informationen finden Sie unter XML_OPEN.

Syntax

XML_REMOVE_CHILDREN (Element)

Script-Funktion und Parameter

• XML_REMOVE_CHILDREN
  Entfernt alle Unterelemente eines XML-Elements.

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

Beispiel

Das folgende Beispiel öffnet eine strukturierte Dokumentationsseite als XML-Dokument. Das erste Element wird 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: