DomNode->append_sibling

Descripción

Esta función agrega un hermano a un nodo existente. El hijo puede ser creado, por ejemplo, con domdocument_create_element(), domdocument_create_text() etc. o simplemente mediante el uso de otro nodo.

Antes de que un nuevo hermano sea agregado, éste es duplicado. Por lo tanto, el nuevo hijo es una copia completamente nueva que puede modificarse sin cambiar el nodo que fue pasado a ésta función. Si el nodo pasado tiene hijos, ellos serán duplicados también, lo que facilita enormemente la duplicación de partes grandes de un documento XML. El valor de retorno es el hermano agregado. Si planea hacer modificaciones posteriores al hermano agregado, debe usar el nodo devuelto.

Esta función ha sido agregada para ofrecer el comportamiento de domnode_append_child(), del modo que funcionaba hasta PHP 4.2.

Vea también domnode_append_before().