php-doc-en/reference/domxml/functions/DomNode-append-sibling.xml
Hannes Magnusson c030e2adf7 Upgrade to DocBook5:
- All id attributes are now xml:id
 - Add docbook namespace to all root elements
 - Replace <ulink /> with <link xlink:href />
 - Minor markup fixes here and there


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@238160 c90b9560-bf6c-de11-be94-00142212c4b1
2007-06-20 22:25:43 +00:00

61 lines
1.9 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.9 $ -->
<refentry xml:id='function.domnode-append-sibling' xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>DomNode->append_sibling</refname>
<refpurpose>
Adds new sibling to a node
</refpurpose>
</refnamediv>
<refsect1>
&reftitle.description;
<methodsynopsis>
<type>domelement</type><methodname>DomNode->append_sibling</methodname>
<methodparam><type>domelement</type><parameter>newnode</parameter></methodparam>
</methodsynopsis>
<para>
This functions appends a sibling to an existing node.
The child can be created with e.g.
<function>domdocument_create_element</function>,
<function>domdocument_create_text</function> etc. or simply by using any
other node.
</para>
<para>
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 an 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.
</para>
<para>
This function has been added to provide the behaviour of
<function>domnode_append_child</function> as it works till PHP 4.2.
</para>
<para>
See also <function>domnode_append_before</function>.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->