XML_REMOVE_CHILDREN

Fonction de script : Supprime tous les sous-éléments d'un élément XML.

Syntaxe

XML_REMOVE_CHILDREN (Element)

Elément de syntaxe	Description / format
Element	Référence de l'élément dont le sous-élément doit être supprimé. Format : littéral de script ou variable de script

Code retour
"0" : tous les sous-éléments de l'élément spécifié ont été supprimés avec succès.

Remarques :

L'élément de script supprime tous les éléments subordonnés d'un élément spécifié dans le document XML ouvert (XML_OPEN). La référence de l'élément doit être spécifiée. L'élément de script renvoie le code retour "0", une fois le sous-élément supprimé avec succès.

L'élément de script ne fait que copier la structure XML enregistrée en mémoire. L'onglet Documentation n'est pas affecté.

Exemple

L'exemple suivant illustre l'ouverture d'un onglet Documentation structurée en tant que document XML. Le premier élément est alors spécifié et tous ses sous-éléments sont supprimés. Si la suppression a réussi, le message correspondant est écrit dans le rapport d'activation.

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

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