<- domnode->appendchild() domnode->attributes ->

DomNode->append_child

(no version information, might be only in CVS)

DomNode->append_child -- Ajoute un nouveau fils à la fin des enfants

Description

class DOMNode {

DOMNode append_child ( DOMNode newnode )

}

Cette fonction ajoute un fils à une liste existante de fils ou crée une nouvelle liste de fils.

Liste de paramètres

newnode: Le noeud qui sera ajouté. Il peut être créé avec DomDocument->create_element, DomDocument->create_text_node etc. ou simplement en utilisant un autre noeud.
Note : Vous ne pouvez pas ajouter un DOMAttribute en utilisant cette méthode. Utilisez DomElement->set_attribute() à la place.

Valeurs de retour

Retourne le noeud ajouté en cas de succès ou FALSE en cas d'échec.

Historique

Version	Description
4.3.0	Vous n'êtes plus autorisé d'insérer un noeud à partir d'un autre document.
4.3.0	Avant PHP 4.3.0, le nouveau fils est dupliqué avant d'être ajouté. Par conséquent, le nouveau fils est une copie qui peut être modifiée sans altérer le noeud utilisé dans cette fonction. Si le noeud passé a des fils, ils seront aussi dupliqués, ce qui rend cette fonction pratique pour copier des documents XML complexes. La valeur retournée est le noeud fils ajouté. Si vous voulez apporter des modifications au noeud fils, vous devez utiliser le noeud retourné.
4.3.0 et 4.3.1	Le nouveau fils `newnode` est d'abord déconnecté de son contexte, s'il est déjà fils d'un DomNode. Le noeud est donc déplacé et n'est plus copié. Ceci est le comportement qui correspond aux spécifications W3C. Si vous avez besoin de l'ancien comportement, utilisez DomNode->clone_node avant d'ajouter.
4.3.2	Le nouveau fils `newnode` est d'abord déconnecté de son contexte, s'il est déjà dans l'arbre. Les mêmes règles s'appliquent.

Exemples

L'exemple suivant ajoute un nouveau noeud dans un document, et modifie son attribut align à left.

Exemple 1. Ajouter un noeud fils avec dom xml


<?php

$doc = domxml_new_doc("1.0");

$node = $doc->create_element("para");

$newnode = $doc->append_child($node);

$newnode->set_attribute("align", "left");

?>

L'exemple ci-dessus peut être aussi écrit comme ceci :

Exemple 2. Ajouter un noeud fils avec dom xml (méthode 2)


<?php

$doc = domxml_new_doc("1.0");

$node = $doc->create_element("para");

$node->set_attribute("align", "left");

$newnode = $doc->append_child($node);

?>

Un exemple plus complexe est celui ci-dessous. Il commence par rechercher un élément, le duplique avec ses fils, et l'ajoute comme frère. Finalement, un nouvel attribut est ajouté, et le document complet est publié.

Exemple 3. Ajouter un noeud fils avec DOM XML (exemple 3)


<?php

include("exemple.inc");



if(!$dom = domxml_open_mem($xmlstr)) {

  echo "Erreur lors de l'analyse du document\n";

  exit;

}



$elements = $dom->get_elements_by_tagname("informaltable");

print_r($elements);

$element = $elements[0];



$parent = $element->parent_node();

$newnode = $parent->append_child($element);

$children = $newnode->children();

$attr = $children[1]->set_attribute("align", "left");



$xmlfile = $dom->dump_mem();

echo htmlentities($xmlfile);

?>

L'exemple ci-dessus peut aussi être réalisé avec la fonction DomNode->insert_before au lieu de DomNode->append_child.

Migration vers PHP 5

Vous devriez utiliser DOMNode->appendChild().

Voir aussi

DomNode->insert_before

DomNode->clone_node

Rechercher une fonction PHP

<- domnode->appendchild() domnode->attributes ->

Réseaux sociaux

|Plus d'options...

Vous pouvez modifier vos préférences dans votre profil pour ne plus afficher les interactions avec les réseaux sociaux sur ces pages.

Nuage de mots clés

5 mots clés dont 0 définis manuellement (plus d'information...).

Avertissement

Cette page ne possède pas encore de mots clés manuels, ceci est donc un exemple automatique (les niveaux de pertinence sont fictifs, mais les liens sont valables). Pour tester le nuage avec une page qui contient des mots définis manuellement, vous pouvez cliquer ici.

Vous pouvez modifier vos préférences dans votre profil pour ne plus afficher le nuage de mots clés.

Références

Manuel PHP : http://be2.php.net, domnode->append_child

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Structure du document

Réseaux sociaux
Nuage de mots clés
- Avertissement :
Références

Astuce pour imprimer les couleurs des cellules de tableaux : http://www.gaudry.be/ast-rf-450.html

Aucun commentaire pour cette page

tection. Enregistrement IDDN n° 5329-5295
Document créé le 30/10/06 04:03, dernière modification le Vendredi 17 Juin 2011, 12:12
Source du document imprimé : http://www.gaudry.be/php-rf-function.domnode-append-child.html Document affiché 2 fois ce mois de Juin.
St.Gaudry©07.01.02