Remplace un fils

# DOMNode::replaceChild

(PHP 5, PHP 7, PHP 8)

DOMNode::replaceChild — Remplace un fils

### Description

public function DOMNode::replaceChild(DOMNode `$node`, DOMNode `$child`): DOMNode|false

Cette fonction remplace le fils `child` par le nouveau nœud spécifié. Si `node` est déjà un fils, il ne sera pas ajouté une seconde fois. Si le remplacement réussit, l'ancien nœud sera retourné.

### Liste de paramètres

`node`

  Le nouveau nœud. Il doit être membre du document cible, c.-à-d. créé par une des méthodes de DOMDocument->createXXX() ou importé dans le document par DOMDocument::importNode.

`child`

  L'ancien nœud.

### Valeurs de retour

L'ancien nœud ou `false` si une erreur survient.

### Erreurs / Exceptions

Peut lancer une DOMException avec les codes d'erreur suivants :

`DOM_NO_MODIFICATION_ALLOWED_ERR`

  Levé si le nœud est en lecture seule ou si le parent précédent du nœud à insérer est en lecture seule.

`DOM_HIERARCHY_REQUEST_ERR`

  Levé si le nœud est d'un type qui n'autorise pas les fils du type du nœud `node`, ou si le nœud à insérer est un des ancêtres de ce nœud ou ce nœud lui-même.

`DOM_WRONG_DOCUMENT_ERR`

  Levé si `node` a été créé à partir d'un document différent de celui qui a créé ce nœud.

`DOM_NOT_FOUND_ERR`

  Levé si `child` n'est pas un fils de ce nœud.

### Voir aussi

- DOMChildNode::replaceWith() - Remplace le nœud par de nouveaux nœuds
- DOMNode::appendChild() - Ajoute un nouveau fils à la fin des fils
- DOMNode::removeChild() - Supprime un fils de la liste des enfants

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open