Forum und email

DOMNode->replaceChild()

(No version information available, might be only in CVS)

DOMNode->replaceChild() — Remplace un fils

Description

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

Lancé 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.