diff --git a/reference/domxml/functions/DomNode-append-sibling.xml b/reference/domxml/functions/DomNode-append-sibling.xml new file mode 100644 index 0000000000..41d0e0cbe1 --- /dev/null +++ b/reference/domxml/functions/DomNode-append-sibling.xml @@ -0,0 +1,60 @@ + + + + DomNode->append_sibling + + Adds new sibling to a node + + + + Description + + objectDomNode->append_sibling + objectnewnode + + + 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. + + + + +