DOMNode->appendChild()

DOMNode->appendChild() --  Ajoute un nouveau fils à la fin des fils

Description

class DOMNode {

DOMNode appendChild ( DOMNode newnode )

}

Cette fonction ajoute un fils à une liste de fils existant 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é.

Exceptions

DOM_NO_MODIFICATION_ALLOWED_ERR

Lancé si le noeud est en lecture seul ou si le parent précédent le noeud à insérer est en lecture seul.

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->removeChild()
DOMNode->replaceChild()