DomNode::append_sibling

(PHP 4 >= 4.2.0)

DomNode::append_sibling — Ajoute un frère à un noeud

Description

domelement DomNode::append_sibling ( domelement $newnode )

Cette fonction ajoute le noeud newnode aux fils du noeud courant. newnode peut être créé avec les fonctions domdocument_create_element(), domdocument_create_text(), etc. ou simplement en utilisant un autre noeud.

Avant d'être ajouté, un noeud est d'abord dupliqué. 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é.

Cette fonction a été ajoutée pour fournir un remplaçant à domnode_append_child(), tel qu'il fonctionnait en PHP 4.2.

Voir aussi domnode_append_before().

add a note User Contributed Notes DomNode::append_sibling

s dot girard at pandora dot be 30-Apr-2004 11:06


Small example on the use of domnode->append_sibling()

This function creates a news.xml file, that will be later on parsed with XSLT.



$doc = domxml_new_doc("1.0");

$root = $doc->create_element("rt");

$root = $doc->append_child($root);

$page = $doc->create_element("page");

$page = $root->append_child($page);

$page->set_attribute("pageimage","images/news.jpg");

    

while($row = mysql_fetch_row($result))

{

    $news = $doc->create_element("news");

    $news = $page->append_child($news);

        

    $topic = $doc->create_element("topic");

    $topic = $news->append_child($topic);

        

    $topic_content = $doc->create_text_node($row[0]);

    $topic_content = $topic->append_child($topic_content);

        

    $user = $doc->create_element("user");

    $user = $topic->append_sibling($user);

    

    $user_content = $doc->create_text_node($row[3]);

    $user_content = $user->append_child($user_content);

        

    $date = $doc->create_element("date");

    $date = $topic->append_sibling($date);

        

    $date_content = $doc->create_text_node($row[2]);

    $date_content = $date->append_child($date_content);

        

    $body = $doc->create_element("body");

    $body = $topic->append_sibling($body);

        

             $body_content = $doc->create_text_node($row[1]);

    $body_content = $body->append_child($body_content);

}

unlink("./data/news.xml");

$doc->dump_file("./data/news.xml");

add a note