source: NonGTP/Xerces/xerces/doc/html/apiDocs/classDOMNamedNodeMap.html @ 358

Revision 358, 34.1 KB checked in by bittner, 19 years ago (diff)

xerces added
Line 
1<HTML><HEAD><SCRIPT language="JavaScript" src="../resources/script.js" type="text/javascript"></SCRIPT><TITLE>DOMNamedNodeMap class Reference</TITLE><link href="XercesApi.css" rel="stylesheet" type="text/css"></HEAD><BODY alink="#ff0000" bgcolor="#ffffff" leftmargin="4" link="#0000ff" marginheight="4" marginwidth="4" text="#000000" topmargin="4" vlink="#0000aa"><TABLE border="0" cellpadding="0" cellspacing="0" width="620"><TR><TD align="left" height="60" rowspan="3" valign="top" width="135"><IMG border="0" height="60" hspace="0" src="../resources/logo.gif" vspace="0" width="135"></TD><TD align="left" colspan="4" height="5" valign="top" width="456"><IMG border="0" height="5" hspace="0" src="../resources/line.gif" vspace="0" width="456"></TD><TD align="left" height="60" rowspan="3" valign="top" width="29"><IMG border="0" height="60" hspace="0" src="../resources/right.gif" vspace="0" width="29"></TD></TR><TR><TD align="left" bgcolor="#0086b2" colspan="4" height="35" valign="top" width="456"><IMG alt="" border="0" height="35" hspace="0" src="../graphics/api-header.jpg" vspace="0" width="456"></TD></TR><TR><TD align="left" height="20" valign="top" width="168"><IMG border="0" height="20" hspace="0" src="../resources/bottom.gif" vspace="0" width="168"></TD><TD align="left" height="20" valign="top" width="96"><A href="http://xml.apache.org/" onMouseOut="rolloverOff('xml');" onMouseOver="rolloverOn('xml');" target="new"><IMG alt="http://xml.apache.org/" border="0" height="20" hspace="0" name="xml" onLoad="rolloverLoad('xml','../resources/button-xml-hi.gif','../resources/button-xml-lo.gif');" src="../resources/button-xml-lo.gif" vspace="0" width="96"></A></TD><TD align="left" height="20" valign="top" width="96"><A href="http://www.apache.org/" onMouseOut="rolloverOff('asf');" onMouseOver="rolloverOn('asf');" target="new"><IMG alt="http://www.apache.org/" border="0" height="20" hspace="0" name="asf" onLoad="rolloverLoad('asf','../resources/button-asf-hi.gif','../resources/button-asf-lo.gif');" src="../resources/button-asf-lo.gif" vspace="0" width="96"></A></TD><TD align="left" height="20" valign="top" width="96"><A href="http://www.w3.org/" onMouseOut="rolloverOff('w3c');" onMouseOver="rolloverOn('w3c');" target="new"><IMG alt="http://www.w3.org/" border="0" height="20" hspace="0" name="w3c" onLoad="rolloverLoad('w3c','../resources/button-w3c-hi.gif','../resources/button-w3c-lo.gif');" src="../resources/button-w3c-lo.gif" vspace="0" width="96"></A></TD></TR></TABLE><TABLE border="0" cellpadding="0" cellspacing="0" width="620"><TR><TD align="left" valign="top" width="120"><IMG border="0" height="14" hspace="0" src="../resources/join.gif" vspace="0" width="120"><BR>
2  <A href="../../index.html" onMouseOut="rolloverOff('side-ext-2');" onMouseOver="rolloverOn('side-ext-2');"><IMG alt="Home" border="0" height="12" hspace="0" name="side-ext-2" onLoad="rolloverLoad('side-ext-2','../graphics/ext-2-label-2.jpg','../graphics/ext-2-label-3.jpg');" src="../graphics/ext-2-label-3.jpg" vspace="0" width="120"></A><BR>
3
4  <IMG border="0" height="6" hspace="0" src="../resources/separator.gif" vspace="0" width="120"><BR>
5
6  <A href="../index.html" onMouseOut="rolloverOff('side-index');" onMouseOver="rolloverOn('side-index');"><IMG alt="Readme" border="0" height="12" hspace="0" name="side-index" onLoad="rolloverLoad('side-index','../graphics/index-label-2.jpg','../graphics/index-label-3.jpg');" src="../graphics/index-label-3.jpg" vspace="0" width="120"></A><BR>
7  <A href="../releases.html" onMouseOut="rolloverOff('side-releases');" onMouseOver="rolloverOn('side-releases');"><IMG alt="Release Info" border="0" height="12" hspace="0" name="side-releases" onLoad="rolloverLoad('side-releases','../graphics/releases-label-2.jpg','../graphics/releases-label-3.jpg');" src="../graphics/releases-label-3.jpg" vspace="0" width="120"></A><BR>
8  <IMG border="0" height="6" hspace="0" src="../resources/separator.gif" vspace="0" width="120"><BR>
9  <A href="../install.html" onMouseOut="rolloverOff('side-install');" onMouseOver="rolloverOn('side-install');"><IMG alt="Installation" border="0" height="12" hspace="0" name="side-install" onLoad="rolloverLoad('side-install','../graphics/install-label-2.jpg','../graphics/install-label-3.jpg');" src="../graphics/install-label-3.jpg" vspace="0" width="120"></A><BR>
10  <A href="http://xml.apache.org/dist/xerces-c/" onMouseOut="rolloverOff('side-ext-18');" onMouseOver="rolloverOn('side-ext-18');"><IMG alt="Download" border="0" height="12" hspace="0" name="side-ext-18" onLoad="rolloverLoad('side-ext-18','../graphics/ext-18-label-2.jpg','../graphics/ext-18-label-3.jpg');" src="../graphics/ext-18-label-3.jpg" vspace="0" width="120"></A><BR>
11  <A href="../build.html" onMouseOut="rolloverOff('side-build');" onMouseOver="rolloverOn('side-build');"><IMG alt="Build" border="0" height="12" hspace="0" name="side-build" onLoad="rolloverLoad('side-build','../graphics/build-label-2.jpg','../graphics/build-label-3.jpg');" src="../graphics/build-label-3.jpg" vspace="0" width="120"></A><BR>
12
13  <IMG border="0" height="6" hspace="0" src="../resources/separator.gif" vspace="0" width="120"><BR>
14  <A href="../faqs.html" onMouseOut="rolloverOff('side-faqs');" onMouseOver="rolloverOn('side-faqs');"><IMG alt="FAQs" border="0" height="12" hspace="0" name="side-faqs" onLoad="rolloverLoad('side-faqs','../graphics/faqs-label-2.jpg','../graphics/faqs-label-3.jpg');" src="../graphics/faqs-label-3.jpg" vspace="0" width="120"></A><BR> 
15  <A href="../samples.html" onMouseOut="rolloverOff('side-samples');" onMouseOver="rolloverOn('side-samples');"><IMG alt="Samples" border="0" height="12" hspace="0" name="side-samples" onLoad="rolloverLoad('side-samples','../graphics/samples-label-2.jpg','../graphics/samples-label-3.jpg');" src="../graphics/samples-label-3.jpg" vspace="0" width="120"></A><BR>
16  <A href="../api.html" onMouseOut="rolloverOff('side-api');" onMouseOver="rolloverOn('side-api');"><IMG alt="API Docs" border="0" height="12" hspace="0" name="side-api" onLoad="rolloverLoad('side-api','../graphics/api-label-2.jpg','../graphics/api-label-3.jpg');" src="../graphics/api-label-3.jpg" vspace="0" width="120"></A><BR> 
17
18  <IMG border="0" height="6" hspace="0" src="../resources/separator.gif" vspace="0" width="120"><BR> 
19  <A href="../ApacheDOMC++Binding.html" onMouseOut="rolloverOff('side-ext-68');" onMouseOver="rolloverOn('side-ext-68');"><IMG alt="DOM C++ Binding" border="0" height="12" hspace="0" name="side-ext-68" onLoad="rolloverLoad('side-ext-68','../graphics/ext-68-label-2.jpg','../graphics/ext-68-label-3.jpg');" src="../graphics/ext-68-label-3.jpg" vspace="0" width="120"></A><BR>
20
21  <A href="../program.html" onMouseOut="rolloverOff('side-program');" onMouseOver="rolloverOn('side-program');"><IMG alt="Programming" border="0" height="12" hspace="0" name="side-program" onLoad="rolloverLoad('side-program','../graphics/program-label-2.jpg','../graphics/program-label-3.jpg');" src="../graphics/program-label-3.jpg" vspace="0" width="120"></A><BR>
22  <A href="../migrate.html" onMouseOut="rolloverOff('side-migrate');" onMouseOver="rolloverOn('side-migrate');"><IMG alt="Migration Guide" border="0" height="12" hspace="0" name="side-migrate" onLoad="rolloverLoad('side-migrate','../graphics/migrate-label-2.jpg','../graphics/migrate-label-3.jpg');" src="../graphics/migrate-label-3.jpg" vspace="0" width="120"></A><BR>
23
24  <IMG border="0" height="6" hspace="0" src="../resources/separator.gif" vspace="0" width="120"><BR>
25
26  <A href="../feedback.html" onMouseOut="rolloverOff('side-feedback');" onMouseOver="rolloverOn('side-feedback');"><IMG alt="Feedback" border="0" height="12" hspace="0" name="side-feedback" onLoad="rolloverLoad('side-feedback','../graphics/feedback-label-2.jpg','../graphics/feedback-label-3.jpg');" src="../graphics/feedback-label-3.jpg" vspace="0" width="120"></A><BR>
27  <A href="../bug-report.html" onMouseOut="rolloverOff('side-bug-report');" onMouseOver="rolloverOn('side-bug-report');"><IMG alt="Bug-Reporting" border="0" height="12" hspace="0" name="side-bug-report" onLoad="rolloverLoad('side-bug-report','../graphics/bug-report-label-2.jpg','../graphics/bug-report-label-3.jpg');" src="../graphics/bug-report-label-3.jpg" vspace="0" width="120"></A><BR> 
28  <A href="../pdf.html" onMouseOut="rolloverOff('side-pdf');" onMouseOver="rolloverOn('side-pdf');"><IMG alt="PDF Document" border="0" height="12" hspace="0" name="side-pdf" onLoad="rolloverLoad('side-pdf','../graphics/pdf-label-2.jpg','../graphics/pdf-label-3.jpg');" src="../graphics/pdf-label-3.jpg" vspace="0" width="120"></A><BR>
29
30  <IMG border="0" height="6" hspace="0" src="../resources/separator.gif" vspace="0" width="120"><BR>
31
32  <A href="http://xml.apache.org/websrc/cvsweb.cgi/xml-xerces/c/" onMouseOut="rolloverOff('side-ext-100');" onMouseOver="rolloverOn('side-ext-100');"><IMG alt="CVS Repository" border="0" height="12" hspace="0" name="side-ext-100" onLoad="rolloverLoad('side-ext-100','../graphics/ext-100-label-2.jpg','../graphics/ext-100-label-3.jpg');" src="../graphics/ext-100-label-3.jpg" vspace="0" width="120"></A><BR>
33
34  <A href="http://marc.theaimsgroup.com/?l=xerces-c-dev" onMouseOut="rolloverOff('side-ext-102');" onMouseOver="rolloverOn('side-ext-102');"><IMG alt="Mail Archive" border="0" height="12" hspace="0" name="side-ext-102" onLoad="rolloverLoad('side-ext-102','../graphics/ext-102-label-2.jpg','../graphics/ext-102-label-3.jpg');" src="../graphics/ext-102-label-3.jpg" vspace="0" width="120"></A><BR>
35
36
37<IMG border="0" height="14" hspace="0" src="../resources/close.gif" vspace="0" width="120"><BR></TD><TD align="left" valign="top" width="500"><TABLE border="0" cellpadding="3" cellspacing="0"><TR><TD>
38    <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#FFFFFF" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="../resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="../resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="../resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="../resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="../resources/void.gif" vspace="0" width="2"><B>API Docs for SAX and DOM</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="../resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="../resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="../resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="../resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10">&nbsp;</TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
39
40            <P>
41<!-- Generated by Doxygen 1.2.14 -->
42<center>
43<a class="qindex" href="index.html">Main Page</a> &nbsp; <a class="qindex" href="hierarchy.html">Class Hierarchy</a> &nbsp; <a class="qindex" href="classes.html">Alphabetical List</a> &nbsp; <a class="qindex" href="annotated.html">Compound List</a> &nbsp; <a class="qindex" href="files.html">File List</a> &nbsp; <a class="qindex" href="functions.html">Compound Members</a> &nbsp; <a class="qindex" href="globals.html">File Members</a> &nbsp; </center>
44<hr><h1>DOMNamedNodeMap  Class Reference</h1><code>DOMNamedNodeMap</code>s are used to represent collections of nodes that can be accessed by name.
45<a href="#_details">More...</a>
46<p>
47<a href="classDOMNamedNodeMap-members.html">List of all members.</a><table border=0 cellpadding=0 cellspacing=0>
48<tr><td colspan=2><br><h2>Public Methods</h2></td></tr>
49<tr><td colspan="2"><div class="groupHeader">Destructor</div></td></tr>
50<tr><td nowrap align=right valign=top>virtual&nbsp;</td><td valign=bottom><a class="el" href="classDOMNamedNodeMap.html#z106_0">~DOMNamedNodeMap</a> ()</td></tr>
51<tr><td>&nbsp;</td><td><font size=-1><em>Destructor.</em> <a href="#z106_0">More...</a><em></em></font><br><br></td></tr>
52<tr><td colspan="2"><div class="groupHeader">Functions introduced in DOM Level 1</div></td></tr>
53<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMNode.html">DOMNode</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMNamedNodeMap.html#z107_0">setNamedItem</a> (<a class="el" href="classDOMNode.html">DOMNode</a> *arg)=0</td></tr>
54<tr><td>&nbsp;</td><td><font size=-1><em>Adds a node using its <code>nodeName</code> attribute.</em> <a href="#z107_0">More...</a><em></em></font><br><br></td></tr>
55<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMNode.html">DOMNode</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMNamedNodeMap.html#z107_1">item</a> (XMLSize_t index) const=0</td></tr>
56<tr><td>&nbsp;</td><td><font size=-1><em>Returns the <code>index</code>th item in the map.</em> <a href="#z107_1">More...</a><em></em></font><br><br></td></tr>
57<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMNode.html">DOMNode</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMNamedNodeMap.html#z107_2">getNamedItem</a> (const XMLCh *name) const=0</td></tr>
58<tr><td>&nbsp;</td><td><font size=-1><em>Retrieves a node specified by name.</em> <a href="#z107_2">More...</a><em></em></font><br><br></td></tr>
59<tr><td nowrap align=right valign=top>virtual XMLSize_t&nbsp;</td><td valign=bottom><a class="el" href="classDOMNamedNodeMap.html#z107_3">getLength</a> () const=0</td></tr>
60<tr><td>&nbsp;</td><td><font size=-1><em>The number of nodes in the map.</em> <a href="#z107_3">More...</a><em></em></font><br><br></td></tr>
61<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMNode.html">DOMNode</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMNamedNodeMap.html#z107_4">removeNamedItem</a> (const XMLCh *name)=0</td></tr>
62<tr><td>&nbsp;</td><td><font size=-1><em>Removes a node specified by name.</em> <a href="#z107_4">More...</a><em></em></font><br><br></td></tr>
63<tr><td colspan="2"><div class="groupHeader">Functions introduced in DOM Level 2</div></td></tr>
64<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMNode.html">DOMNode</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMNamedNodeMap.html#z108_0">getNamedItemNS</a> (const XMLCh *namespaceURI, const XMLCh *localName) const=0</td></tr>
65<tr><td>&nbsp;</td><td><font size=-1><em>Retrieves a node specified by local name and namespace URI.</em> <a href="#z108_0">More...</a><em></em></font><br><br></td></tr>
66<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMNode.html">DOMNode</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMNamedNodeMap.html#z108_1">setNamedItemNS</a> (<a class="el" href="classDOMNode.html">DOMNode</a> *arg)=0</td></tr>
67<tr><td>&nbsp;</td><td><font size=-1><em>Adds a node using its <code>namespaceURI</code> and <code>localName</code>.</em> <a href="#z108_1">More...</a><em></em></font><br><br></td></tr>
68<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMNode.html">DOMNode</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMNamedNodeMap.html#z108_2">removeNamedItemNS</a> (const XMLCh *namespaceURI, const XMLCh *localName)=0</td></tr>
69<tr><td>&nbsp;</td><td><font size=-1><em>Removes a node specified by local name and namespace URI.</em> <a href="#z108_2">More...</a><em></em></font><br><br></td></tr>
70<tr><td colspan=2><br><h2>Protected Methods</h2></td></tr>
71<tr><td colspan="2"><div class="groupHeader">Hidden constructors</div></td></tr>
72<tr><td nowrap align=right valign=top>&nbsp;</td><td valign=bottom><a class="el" href="classDOMNamedNodeMap.html#z104_0">DOMNamedNodeMap</a> ()</td></tr>
73</table>
74<hr><a name="_details"></a><h2>Detailed Description</h2>
75<code>DOMNamedNodeMap</code>s are used to represent collections of nodes that can be accessed by name.
76<p>
77Note that <code>DOMNamedNodeMap</code> does not inherit from <code><a class="el" href="classDOMNodeList.html">DOMNodeList</a></code>; <code>DOMNamedNodeMap</code>s are not maintained in any particular order. Nodes contained in a <code>DOMNamedNodeMap</code> may also be accessed by an ordinal index, but this is simply to allow convenient enumeration of the contents, and does not imply that the DOM specifies an order to these Nodes.
78<p>
79<dl compact><dt><b>
80Since: </b><dd>
81DOM Level 1 </dl>
82<p>
83<hr><h2>Constructor &amp; Destructor Documentation</h2>
84<a name="z104_0" doxytag="DOMNamedNodeMap::DOMNamedNodeMap"></a><p>
85<table width="100%" cellpadding="2" cellspacing="0" border="0">
86  <tr>
87    <td class="md">
88      <table cellpadding="0" cellspacing="0" border="0">
89        <tr>
90          <td class="md" nowrap valign="top"> DOMNamedNodeMap::DOMNamedNodeMap </td>
91          <td class="md" valign="top">(&nbsp;</td>
92          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
93          <td class="md" valign="top">)&nbsp;</td>
94          <td class="md" nowrap><code> [protected]</code></td>
95        </tr>
96
97      </table>
98    </td>
99  </tr>
100</table>
101<table cellspacing=5 cellpadding=0 border=0>
102  <tr>
103    <td>
104      &nbsp;
105    </td>
106    <td>
107
108<p>
109    </td>
110  </tr>
111</table>
112<a name="z106_0" doxytag="DOMNamedNodeMap::~DOMNamedNodeMap"></a><p>
113<table width="100%" cellpadding="2" cellspacing="0" border="0">
114  <tr>
115    <td class="md">
116      <table cellpadding="0" cellspacing="0" border="0">
117        <tr>
118          <td class="md" nowrap valign="top"> virtual DOMNamedNodeMap::~DOMNamedNodeMap </td>
119          <td class="md" valign="top">(&nbsp;</td>
120          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
121          <td class="md" valign="top">)&nbsp;</td>
122          <td class="md" nowrap><code> [virtual]</code></td>
123        </tr>
124
125      </table>
126    </td>
127  </tr>
128</table>
129<table cellspacing=5 cellpadding=0 border=0>
130  <tr>
131    <td>
132      &nbsp;
133    </td>
134    <td>
135
136<p>
137Destructor.
138<p>
139    </td>
140  </tr>
141</table>
142<hr><h2>Member Function Documentation</h2>
143<a name="z107_3" doxytag="DOMNamedNodeMap::getLength"></a><p>
144<table width="100%" cellpadding="2" cellspacing="0" border="0">
145  <tr>
146    <td class="md">
147      <table cellpadding="0" cellspacing="0" border="0">
148        <tr>
149          <td class="md" nowrap valign="top"> virtual XMLSize_t DOMNamedNodeMap::getLength </td>
150          <td class="md" valign="top">(&nbsp;</td>
151          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
152          <td class="md" valign="top">)&nbsp;</td>
153          <td class="md" nowrap> const<code> [pure virtual]</code></td>
154        </tr>
155
156      </table>
157    </td>
158  </tr>
159</table>
160<table cellspacing=5 cellpadding=0 border=0>
161  <tr>
162    <td>
163      &nbsp;
164    </td>
165    <td>
166
167<p>
168The number of nodes in the map.
169<p>
170The range of valid child node indices is 0 to <code>length-1</code> inclusive. <dl compact><dt><b>
171Since: </b><dd>
172DOM Level 1 </dl>    </td>
173  </tr>
174</table>
175<a name="z107_2" doxytag="DOMNamedNodeMap::getNamedItem"></a><p>
176<table width="100%" cellpadding="2" cellspacing="0" border="0">
177  <tr>
178    <td class="md">
179      <table cellpadding="0" cellspacing="0" border="0">
180        <tr>
181          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMNode.html">DOMNode</a>* DOMNamedNodeMap::getNamedItem </td>
182          <td class="md" valign="top">(&nbsp;</td>
183          <td class="md" nowrap valign="top">const XMLCh *&nbsp;</td>
184          <td class="mdname1" valign="top" nowrap>&nbsp; <em>name</em>          </td>
185          <td class="md" valign="top">)&nbsp;</td>
186          <td class="md" nowrap> const<code> [pure virtual]</code></td>
187        </tr>
188
189      </table>
190    </td>
191  </tr>
192</table>
193<table cellspacing=5 cellpadding=0 border=0>
194  <tr>
195    <td>
196      &nbsp;
197    </td>
198    <td>
199
200<p>
201Retrieves a node specified by name.
202<p>
203<dl compact><dt><b>
204Parameters: </b><dd>
205<table border=0 cellspacing=2 cellpadding=0>
206<tr><td valign=top><em>name</em>&nbsp;</td><td>
207The <code>nodeName</code> of a node to retrieve. </td></tr>
208</table>
209</dl><dl compact><dt><b>
210Returns: </b><dd>
211A <code><a class="el" href="classDOMNode.html">DOMNode</a></code> (of any type) with the specified <code>nodeName</code>, or <code>null</code> if it does not identify any node in the map. </dl><dl compact><dt><b>
212Since: </b><dd>
213DOM Level 1 </dl>    </td>
214  </tr>
215</table>
216<a name="z108_0" doxytag="DOMNamedNodeMap::getNamedItemNS"></a><p>
217<table width="100%" cellpadding="2" cellspacing="0" border="0">
218  <tr>
219    <td class="md">
220      <table cellpadding="0" cellspacing="0" border="0">
221        <tr>
222          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMNode.html">DOMNode</a>* DOMNamedNodeMap::getNamedItemNS </td>
223          <td class="md" valign="top">(&nbsp;</td>
224          <td class="md" nowrap valign="top">const XMLCh *&nbsp;</td>
225          <td class="mdname" nowrap>&nbsp; <em>namespaceURI</em>, </td>
226        </tr>
227        <tr>
228          <td></td>
229          <td></td>
230          <td class="md" nowrap>const XMLCh *&nbsp;</td>
231          <td class="mdname" nowrap>&nbsp; <em>localName</em></td>
232        </tr>
233        <tr>
234          <td></td>
235          <td class="md">)&nbsp;</td>
236          <td class="md" colspan="2"> const<code> [pure virtual]</code></td>
237        </tr>
238
239      </table>
240    </td>
241  </tr>
242</table>
243<table cellspacing=5 cellpadding=0 border=0>
244  <tr>
245    <td>
246      &nbsp;
247    </td>
248    <td>
249
250<p>
251Retrieves a node specified by local name and namespace URI.
252<p>
253<dl compact><dt><b>
254Parameters: </b><dd>
255<table border=0 cellspacing=2 cellpadding=0>
256<tr><td valign=top><em>namespaceURI</em>&nbsp;</td><td>
257The <em>namespace URI</em> of the node to retrieve. </td></tr>
258<tr><td valign=top><em>localName</em>&nbsp;</td><td>
259The <em>local name</em> of the node to retrieve. </td></tr>
260</table>
261</dl><dl compact><dt><b>
262Returns: </b><dd>
263A <code><a class="el" href="classDOMNode.html">DOMNode</a></code> (of any type) with the specified local name and namespace URI, or <code>null</code> if they do not identify any node in the map. </dl><dl compact><dt><b>
264Since: </b><dd>
265DOM Level 2 </dl>    </td>
266  </tr>
267</table>
268<a name="z107_1" doxytag="DOMNamedNodeMap::item"></a><p>
269<table width="100%" cellpadding="2" cellspacing="0" border="0">
270  <tr>
271    <td class="md">
272      <table cellpadding="0" cellspacing="0" border="0">
273        <tr>
274          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMNode.html">DOMNode</a>* DOMNamedNodeMap::item </td>
275          <td class="md" valign="top">(&nbsp;</td>
276          <td class="md" nowrap valign="top">XMLSize_t&nbsp;</td>
277          <td class="mdname1" valign="top" nowrap>&nbsp; <em>index</em>          </td>
278          <td class="md" valign="top">)&nbsp;</td>
279          <td class="md" nowrap> const<code> [pure virtual]</code></td>
280        </tr>
281
282      </table>
283    </td>
284  </tr>
285</table>
286<table cellspacing=5 cellpadding=0 border=0>
287  <tr>
288    <td>
289      &nbsp;
290    </td>
291    <td>
292
293<p>
294Returns the <code>index</code>th item in the map.
295<p>
296If <code>index</code> is greater than or equal to the number of nodes in the map, this returns <code>null</code>. <dl compact><dt><b>
297Parameters: </b><dd>
298<table border=0 cellspacing=2 cellpadding=0>
299<tr><td valign=top><em>index</em>&nbsp;</td><td>
300Index into the map. </td></tr>
301</table>
302</dl><dl compact><dt><b>
303Returns: </b><dd>
304The node at the <code>index</code>th position in the <code>DOMNamedNodeMap</code>, or <code>null</code> if that is not a valid index. </dl><dl compact><dt><b>
305Since: </b><dd>
306DOM Level 1 </dl>    </td>
307  </tr>
308</table>
309<a name="z107_4" doxytag="DOMNamedNodeMap::removeNamedItem"></a><p>
310<table width="100%" cellpadding="2" cellspacing="0" border="0">
311  <tr>
312    <td class="md">
313      <table cellpadding="0" cellspacing="0" border="0">
314        <tr>
315          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMNode.html">DOMNode</a>* DOMNamedNodeMap::removeNamedItem </td>
316          <td class="md" valign="top">(&nbsp;</td>
317          <td class="md" nowrap valign="top">const XMLCh *&nbsp;</td>
318          <td class="mdname1" valign="top" nowrap>&nbsp; <em>name</em>          </td>
319          <td class="md" valign="top">)&nbsp;</td>
320          <td class="md" nowrap><code> [pure virtual]</code></td>
321        </tr>
322
323      </table>
324    </td>
325  </tr>
326</table>
327<table cellspacing=5 cellpadding=0 border=0>
328  <tr>
329    <td>
330      &nbsp;
331    </td>
332    <td>
333
334<p>
335Removes a node specified by name.
336<p>
337If the removed node is an <code><a class="el" href="classDOMAttr.html">DOMAttr</a></code> with a default value it is immediately replaced. <dl compact><dt><b>
338Parameters: </b><dd>
339<table border=0 cellspacing=2 cellpadding=0>
340<tr><td valign=top><em>name</em>&nbsp;</td><td>
341The <code>nodeName</code> of a node to remove. </td></tr>
342</table>
343</dl><dl compact><dt><b>
344Returns: </b><dd>
345The node removed from the map if a node with such a name exists. </dl><dl compact><dt><b>
346Exceptions: </b><dd>
347<table border=0 cellspacing=2 cellpadding=0>
348<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
349 NOT_FOUND_ERR: Raised if there is no node named <code>name</code> in the map. <br>
350 NO_MODIFICATION_ALLOWED_ERR: Raised if this <code>DOMNamedNodeMap</code> is readonly. </td></tr>
351</table>
352</dl><dl compact><dt><b>
353Since: </b><dd>
354DOM Level 1 </dl>    </td>
355  </tr>
356</table>
357<a name="z108_2" doxytag="DOMNamedNodeMap::removeNamedItemNS"></a><p>
358<table width="100%" cellpadding="2" cellspacing="0" border="0">
359  <tr>
360    <td class="md">
361      <table cellpadding="0" cellspacing="0" border="0">
362        <tr>
363          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMNode.html">DOMNode</a>* DOMNamedNodeMap::removeNamedItemNS </td>
364          <td class="md" valign="top">(&nbsp;</td>
365          <td class="md" nowrap valign="top">const XMLCh *&nbsp;</td>
366          <td class="mdname" nowrap>&nbsp; <em>namespaceURI</em>, </td>
367        </tr>
368        <tr>
369          <td></td>
370          <td></td>
371          <td class="md" nowrap>const XMLCh *&nbsp;</td>
372          <td class="mdname" nowrap>&nbsp; <em>localName</em></td>
373        </tr>
374        <tr>
375          <td></td>
376          <td class="md">)&nbsp;</td>
377          <td class="md" colspan="2"><code> [pure virtual]</code></td>
378        </tr>
379
380      </table>
381    </td>
382  </tr>
383</table>
384<table cellspacing=5 cellpadding=0 border=0>
385  <tr>
386    <td>
387      &nbsp;
388    </td>
389    <td>
390
391<p>
392Removes a node specified by local name and namespace URI.
393<p>
394<dl compact><dt><b>
395Parameters: </b><dd>
396<table border=0 cellspacing=2 cellpadding=0>
397<tr><td valign=top><em>namespaceURI</em>&nbsp;</td><td>
398The <em>namespace URI</em> of the node to remove. </td></tr>
399<tr><td valign=top><em>localName</em>&nbsp;</td><td>
400The <em>local name</em> of the node to remove. When this <code>DOMNamedNodeMap</code> contains the attributes attached to an element, as returned by the attributes attribute of the <code><a class="el" href="classDOMNode.html">DOMNode</a></code> interface, if the removed attribute is known to have a default value, an attribute immediately appears containing the default value as well as the corresponding namespace URI, local name, and prefix. </td></tr>
401</table>
402</dl><dl compact><dt><b>
403Returns: </b><dd>
404The node removed from the map if a node with such a local name and namespace URI exists. </dl><dl compact><dt><b>
405Exceptions: </b><dd>
406<table border=0 cellspacing=2 cellpadding=0>
407<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
408 NOT_FOUND_ERR: Raised if there is no node named <code>name</code> in the map. <br>
409 NO_MODIFICATION_ALLOWED_ERR: Raised if this <code>DOMNamedNodeMap</code> is readonly. </td></tr>
410</table>
411</dl><dl compact><dt><b>
412Since: </b><dd>
413DOM Level 2 </dl>    </td>
414  </tr>
415</table>
416<a name="z107_0" doxytag="DOMNamedNodeMap::setNamedItem"></a><p>
417<table width="100%" cellpadding="2" cellspacing="0" border="0">
418  <tr>
419    <td class="md">
420      <table cellpadding="0" cellspacing="0" border="0">
421        <tr>
422          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMNode.html">DOMNode</a>* DOMNamedNodeMap::setNamedItem </td>
423          <td class="md" valign="top">(&nbsp;</td>
424          <td class="md" nowrap valign="top"><a class="el" href="classDOMNode.html">DOMNode</a> *&nbsp;</td>
425          <td class="mdname1" valign="top" nowrap>&nbsp; <em>arg</em>          </td>
426          <td class="md" valign="top">)&nbsp;</td>
427          <td class="md" nowrap><code> [pure virtual]</code></td>
428        </tr>
429
430      </table>
431    </td>
432  </tr>
433</table>
434<table cellspacing=5 cellpadding=0 border=0>
435  <tr>
436    <td>
437      &nbsp;
438    </td>
439    <td>
440
441<p>
442Adds a node using its <code>nodeName</code> attribute.
443<p>
444<br>
445As the <code>nodeName</code> attribute is used to derive the name which the node must be stored under, multiple nodes of certain types (those that have a "special" string value) cannot be stored as the names would clash. This is seen as preferable to allowing nodes to be aliased. <dl compact><dt><b>
446Parameters: </b><dd>
447<table border=0 cellspacing=2 cellpadding=0>
448<tr><td valign=top><em>arg</em>&nbsp;</td><td>
449A node to store in a named node map. The node will later be accessible using the value of the <code>nodeName</code> attribute of the node. If a node with that name is already present in the map, it is replaced by the new one. </td></tr>
450</table>
451</dl><dl compact><dt><b>
452Returns: </b><dd>
453If the new <code><a class="el" href="classDOMNode.html">DOMNode</a></code> replaces an existing node the replaced <code><a class="el" href="classDOMNode.html">DOMNode</a></code> is returned, otherwise <code>null</code> is returned. </dl><dl compact><dt><b>
454Exceptions: </b><dd>
455<table border=0 cellspacing=2 cellpadding=0>
456<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
457 WRONG_DOCUMENT_ERR: Raised if <code>arg</code> was created from a different document than the one that created the <code>DOMNamedNodeMap</code>. <br>
458NO_MODIFICATION_ALLOWED_ERR: Raised if this <code>DOMNamedNodeMap</code> is readonly. <br>
459INUSE_ATTRIBUTE_ERR: Raised if <code>arg</code> is an <code><a class="el" href="classDOMAttr.html">DOMAttr</a></code> that is already an attribute of another <code><a class="el" href="classDOMElement.html">DOMElement</a></code> object. The DOM user must explicitly clone <code><a class="el" href="classDOMAttr.html">DOMAttr</a></code> nodes to re-use them in other elements. </td></tr>
460</table>
461</dl><dl compact><dt><b>
462Since: </b><dd>
463DOM Level 1 </dl>    </td>
464  </tr>
465</table>
466<a name="z108_1" doxytag="DOMNamedNodeMap::setNamedItemNS"></a><p>
467<table width="100%" cellpadding="2" cellspacing="0" border="0">
468  <tr>
469    <td class="md">
470      <table cellpadding="0" cellspacing="0" border="0">
471        <tr>
472          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMNode.html">DOMNode</a>* DOMNamedNodeMap::setNamedItemNS </td>
473          <td class="md" valign="top">(&nbsp;</td>
474          <td class="md" nowrap valign="top"><a class="el" href="classDOMNode.html">DOMNode</a> *&nbsp;</td>
475          <td class="mdname1" valign="top" nowrap>&nbsp; <em>arg</em>          </td>
476          <td class="md" valign="top">)&nbsp;</td>
477          <td class="md" nowrap><code> [pure virtual]</code></td>
478        </tr>
479
480      </table>
481    </td>
482  </tr>
483</table>
484<table cellspacing=5 cellpadding=0 border=0>
485  <tr>
486    <td>
487      &nbsp;
488    </td>
489    <td>
490
491<p>
492Adds a node using its <code>namespaceURI</code> and <code>localName</code>.
493<p>
494<dl compact><dt><b>
495Parameters: </b><dd>
496<table border=0 cellspacing=2 cellpadding=0>
497<tr><td valign=top><em>arg</em>&nbsp;</td><td>
498A node to store in a named node map. The node will later be accessible using the value of the <code>namespaceURI</code> and <code>localName</code> attribute of the node. If a node with those namespace URI and local name is already present in the map, it is replaced by the new one. </td></tr>
499</table>
500</dl><dl compact><dt><b>
501Returns: </b><dd>
502If the new <code><a class="el" href="classDOMNode.html">DOMNode</a></code> replaces an existing node the replaced <code><a class="el" href="classDOMNode.html">DOMNode</a></code> is returned, otherwise <code>null</code> is returned. </dl><dl compact><dt><b>
503Exceptions: </b><dd>
504<table border=0 cellspacing=2 cellpadding=0>
505<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
506 WRONG_DOCUMENT_ERR: Raised if <code>arg</code> was created from a different document than the one that created the <code>DOMNamedNodeMap</code>. <br>
507NO_MODIFICATION_ALLOWED_ERR: Raised if this <code>DOMNamedNodeMap</code> is readonly. <br>
508INUSE_ATTRIBUTE_ERR: Raised if <code>arg</code> is an <code><a class="el" href="classDOMAttr.html">DOMAttr</a></code> that is already an attribute of another <code><a class="el" href="classDOMElement.html">DOMElement</a></code> object. The DOM user must explicitly clone <code><a class="el" href="classDOMAttr.html">DOMAttr</a></code> nodes to re-use them in other elements. </td></tr>
509</table>
510</dl><dl compact><dt><b>
511Since: </b><dd>
512DOM Level 2 </dl>    </td>
513  </tr>
514</table>
515<hr>The documentation for this class was generated from the following file:<ul>
516<li><a class="el" href="DOMNamedNodeMap_8hpp-source.html">DOMNamedNodeMap.hpp</a></ul>
517    </FONT></TD></TR></TABLE><BR>
518</TD></TR></TABLE></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" cellspacing="0" width="620"><TR><TD bgcolor="#0086b2"><IMG height="1" src="images/dot.gif" width="1" alt=""></TD></TR><TR><TD align="center"><FONT color="#0086b2" size="-1"><I>
519              Copyright &copy; 1994-2004 The Apache Software Foundation.
520              All Rights Reserved.
521            </I></FONT></TD></TR></TABLE></BODY></HTML>
Note: See TracBrowser for help on using the repository browser.