Précédent   XXXI. Fonctions DOM  Suivant

DOMNode->appendChild()

(No version information available, might be only in CVS)

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 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 683. 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()

Précédent   Niveau supérieur  Suivant
DOMNamedNodeMap->item()  Sommaire  DOMNode->cloneNode()