CopyXMLNode()

Syntaxe

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

Duplique le '*Noeud' XML spécifié et tout son contenu (texte et noeuds fils) à un nouvel emplacement. Cette fonction peut même copier des noeuds de documents XML différents. Pour déplacer un noeud à un nouvel emplacement, utiliser MoveXMLNode().

Arguments

'*Noeud' indique le noeud à dupliquer.
'*NoeudParent' est le noeud sous lequel le noeud copié sera inséré. Pour insérer le noeud à la racine de l'objet XML, utiliser RootXMLNode().
'*NoeudPrecedent' représente 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.

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'objet 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

Valeur de retour

Renvoie le pointeur du noeud nouvellement copié ou zéro si la duplication n'est pas possible.

OS Supportés

Tous