Remplace un fils

# DOMNode::replaceChild

(PHP 5, PHP 7)

DOMNode::replaceChild — Remplace un fils

### Description

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

Cette fonction remplace le fils `oldnode` par le nouveau noeud spécifié. Si `newnode` 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