DOMNode::appendChild
(PHP 5)
DOMNode::appendChild — Ajoute un nouveau fils à la fin des fils
Description
Cette fonction ajoute un fils à une liste de fils existante ou crée une nouvelle liste de fils. Le fils peut être créé avec, e.g. DOMDocument::createElement(), DOMDocument::createTextNode(), etc. ou simplement en utilisant tout autre noeud.
Liste de paramètres
-
newnode
-
Le fils à ajouter.
Valeurs de retour
Le noeud ajouté.
Erreurs / Exceptions
-
DOM_NO_MODIFICATION_ALLOWED_ERR
-
Lancé si le noeud est en lecture seule ou si le parent précédent le noeud à insérer est en lecture seule.
-
DOM_HIERARCHY_REQUEST_ERR
-
Lancé si le noeud est d'un type qui n'autorise pas d'enfant du type du noeud
newnode
, ou si le noeud à ajouter est un des noeuds ancêtres 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.
Exemples
L'exemple suivant ajoutera un nouveau noeud à un document nouveau.
Exemple #1 Ajout d'un fils
<?php $doc = new DOMDocument; $node = $doc->createElement("para"); $newnode = $doc->appendChild($node); echo $doc->saveXML(); ?>
Voir aussi
- DOMNode::insertBefore() - Ajoute un nouveau fils à la fin des enfants
- DOMNode::removeChild() - Supprime un fils de la liste des enfants
- DOMNode::replaceChild() - Remplace un fils