DomNode_>append_sibling

Description

This functions appends a sibling to an existing node_ The child can be created with e_g_ domdocument_create_element(), domdocument_create_text() etc_ or simply by using any other node_

Before a new sibling is added it is first duplicated_ Therefore the new child is a completely new copy which can be modified without changing the node which was passed to this function_ If the node passed has children itself, they will be duplicated as well, which makes it quite easy to duplicate large parts of a xml document_ The return value is the added sibling_ If you plan to do further modifications on the added sibling you must use the returned node_

This function has been added to provide the behaviour of domnode_append_child() as it works till PHP 4_2_

See also domnode_append_before()_