DOMNode::replaceChild

(PHP 5)

DOMNode::replaceChild — Remplace un fils

Description

public DOMNode DOMNode::replaceChild ( DOMNode $newnode , DOMNode $oldnode )

Cette fonction remplace le fils oldnode par le nouveau noeud spécifié. SI le nouveau noeud est déjà un fils, il ne sera pas ajouté une seconde fois. Si le remplacement réussi, l'ancien noeud sera retourné.

Liste de paramètres

newnode: Le nouveau noeud. Il doit être membre du document cible, i.e. créé par une des méthodes de DOMDocument->createXXX() ou importé dans le document par DOMDocument::importNode.
oldnode: L'ancien noeud.

Valeurs de retour

L'ancien noeud ou FALSE si une erreur survient.

Erreurs / Exceptions

DOM_NO_MODIFICATION_ALLOWED_ERR: Lancé si le noeud est en lecture seule ou si le parent précédent du noeud à insérer est en lecture seule.
DOM_HIERARCHY_REQUEST_ERR: Lancé si le noeud est d'un type qui n'autorise pas les fils du type du noeud newnode, ou si le noeud à insérer est un des ancêtres de ce noeud ou ce noeud lui-même.
DOM_WRONG_DOCUMENT_ERR: Émise si newnode a été créé depuis un document différent que celui qui a créé ce noeud.
DOM_NOT_FOUND: Lancé si oldnode n'est pas un fils de ce noeud.

Voir aussi

DOMNode::appendChild() - Ajoute un nouveau fils à la fin des fils
DOMNode::removeChild() - Supprime un fils de la liste des enfants