pupnp (libupnp) snapshot from SourceForge: git clone git://pupnp.git.sourceforge...
[igd2-for-linux:pandonghui1211s-igd2-for-linux.git] / pupnp_branch-1.6.x / docs / dist / html / ixml / ixmlNode_insertBefore.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2
3 <HTML>
4 <HEAD>
5    <TITLE>EXPORT_SPEC int ixmlNode_insertBefore</TITLE>
6    <META NAME="GENERATOR" CONTENT="DOC++ 3.4.10">
7 </HEAD>
8 <BODY BGCOLOR="#ffffff">
9
10 <H2>EXPORT_SPEC int <A HREF="#DOC.DOCU">ixmlNode_insertBefore</A></H2><H2>(IXML_Node* nodeptr,<BR>&nbsp;  IXML_Node* newChild,<BR>&nbsp;  IXML_Node* refChild )</H2><BLOCKQUOTE>Inserts a new child <B>Node</B> before the existing child <B>Node</B>.</BLOCKQUOTE>
11
12 <A NAME="DOC.DOCU"></A>
13 <HR>
14 <H2>Documentation</H2>
15 <BLOCKQUOTE>Inserts a new child <B>Node</B> before the existing child <B>Node</B>.  
16 <B>refChild</B> can be <TT>NULL</TT>, which inserts <B>newChild</B> at the
17 end of the list of children.  Note that the <B>Node</B> (or <B>Node</B>s) 
18 in <B>newChild</B> must already be owned by the owner document (or have no
19 owner at all) of <B>nodeptr</B> for insertion.  If not, the <B>Node</B> 
20 (or <B>Node</B>s) must be imported into the document using 
21 <B>ixmlDocument_importNode</B>.  If <B>newChild</B> is already in the tree,
22 it is removed first.
23
24 <P></BLOCKQUOTE>
25 <DL><DT><DT><B>Parameters:</B><DD><B>nodeptr</B> -   The parent of the <B>Node</B> before which to 
26 insert the new child. 
27 <BR><B>newChild</B> -   The <B>Node</B> to insert into the tree. 
28 <BR><B>refChild</B> -   The reference child where the new <B>Node</B> 
29 should be inserted. The new <B>Node</B> will
30 appear directly before the reference child. <BR><DT><B>Returns:</B><DD>  [int] An integer representing one of the following:
31 <UL>
32 <LI> <TT>IXML_SUCCESS</TT>: The operation completed successfully.
33 <LI> <TT>IXML_INVALID_PARAMETER</TT>: Either <B>nodeptr</B> or 
34 <B>newChild</B> is <TT>NULL</TT>.
35 <LI> <TT>IXML_HIERARCHY_REQUEST_ERR</TT>: The type of the <B>Node</B> 
36 does not allow children of the type of <B>newChild</B>.
37 <LI> <TT>IXML_WRONG_DOCUMENT_ERR</TT>: <B>newChild</B> has an owner 
38 document that does not match the owner of <B>nodeptr</B>.
39 <LI> <TT>IXML_NO_MODIFICATION_ALLOWED_ERR</TT>: <B>nodeptr</B> is 
40 read-only or the parent of the <B>Node</B> being inserted is 
41 read-only.
42 <LI> <TT>IXML_NOT_FOUND_ERR</TT>: <B>refChild</B> is not a child of 
43 <B>nodeptr</B>.
44 </UL>
45 <BR><DD></DL><P><P><I><A HREF="index.html">Alphabetic index</A></I></P><HR>
46 <BR>
47 This page was generated with the help of <A HREF="http://docpp.sourceforge.net">DOC++</A>.
48 </BODY>
49 </HTML>