CopyXMLNode

CopyXMLNode()

Syntaxe

Resultat = CopyXMLNode(Noeud, NoeudParent [, NoeudPrecedent])

Description

Duplique un noeud et tout son contenu (texte et noeuds fils) à un nouvel emplacement.

Cette fonction peut copier des noeuds de documents XML différents.
Pour déplacer un noeud à un nouvel emplacement, utiliser MoveXMLNode().

Arguments

Noeud Le noeud à dupliquer.

NoeudParent Le noeud sous lequel le noeud copié sera inséré.
Pour insérer le noeud à la racine de l'arbre XML, utiliser RootXMLNode().

NoeudPrecedent (optionnel) Le noeud fils de 'NoeudParent' après lequel le nouveau noeud devra être inséré. Si sa valeur est omise ou égale à 0, le nouveau noeud est inséré en tant que premier fils du noeud parent. Si sa valeur est -1 alors le nouveau noeud est inséré comme dernier fils du noeud parent.

Valeur de retour

Le nouveau noeud si la copie est un succès, zéro sinon.

Remarques

Les règles suivantes doivent être respectées pour que la copie se déroule correctement:
- Le noeud racine ne peut pas être copié
- 'NoeudParent' ne peut pas être de type #PB_XML_Comment ou #PB_XML_CData
- 'NoeudPrecedent' doit être un fils direct du 'NoeudParent' (s'il est spécifié)
- Si l'arbre XML a déjà un noeud principal, seuls les noeuds de type autres que #PB_XML_Normal et #PB_XML_CData peuvent être insérés à la racine

Voir aussi

DeleteXMLNode(), MoveXMLNode()

OS Supportés

Tous

<- ComposeXML() - XML Index - CreateXML() ->

Noeud	Le noeud à dupliquer.
NoeudParent	Le noeud sous lequel le noeud copié sera inséré. Pour insérer le noeud à la racine de l'arbre XML, utiliser RootXMLNode().
NoeudPrecedent (optionnel)	Le noeud fils de 'NoeudParent' après lequel le nouveau noeud devra être inséré. Si sa valeur est omise ou égale à 0, le nouveau noeud est inséré en tant que premier fils du noeud parent. Si sa valeur est -1 alors le nouveau noeud est inséré comme dernier fils du noeud parent.