DOMNode::replaceChild

(PHP 5, PHP 7, PHP 8)

DOMNode::replaceChild — Remplace un fils

Description

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éussi, l'ancien nœud sera retourné.

Liste de paramètres

node

Le nouveau nœud. 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.

child

L'ancien nœud.

Valeurs de retour

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

Erreurs / Exceptions

DOM_NO_MODIFICATION_ALLOWED_ERR

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

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

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