DOMNode::replaceChild

(PHP 5, PHP 7, PHP 8)

DOMNode::replaceChild — Remplace un fils

Description

public 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

Émise si node a été créé depuis un document différent que 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