1 <?xml version="1.0" encoding="ascii"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3 "DTD/xhtml1-transitional.dtd">
4 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
6 <title>lxml.etree.CommentBase</title>
7 <link rel="stylesheet" href="epydoc.css" type="text/css" />
8 <script type="text/javascript" src="epydoc.js"></script>
11 <body bgcolor="white" text="black" link="blue" vlink="#204080"
13 <!-- ==================== NAVIGATION BAR ==================== -->
14 <table class="navbar" border="0" width="100%" cellpadding="0"
15 bgcolor="#a0c0ff" cellspacing="0">
18 <th> <a
19 href="lxml-module.html">Home</a> </th>
22 <th> <a
23 href="module-tree.html">Trees</a> </th>
26 <th> <a
27 href="identifier-index.html">Indices</a> </th>
30 <th> <a
31 href="help.html">Help</a> </th>
33 <!-- Project homepage -->
34 <th class="navbar" align="right" width="100%">
35 <table border="0" cellpadding="0" cellspacing="0">
36 <tr><th class="navbar" align="center"
37 ><a class="navbar" target="_top" href="/">lxml API</a></th>
41 <table width="100%" cellpadding="0" cellspacing="0">
44 <span class="breadcrumbs">
45 <a href="lxml-module.html">Package lxml</a> ::
46 <a href="lxml.etree-module.html">Module etree</a> ::
47 Class CommentBase
51 <table cellpadding="0" cellspacing="0">
52 <!-- hide/show private -->
53 <tr><td align="right"><span class="options">[<a href="javascript:void(0);" class="privatelink"
54 onclick="toggle_private();">hide private</a>]</span></td></tr>
55 <tr><td align="right"><span class="options"
56 >[<a href="frames.html" target="_top">frames</a
57 >] | <a href="lxml.etree.CommentBase-class.html"
58 target="_top">no frames</a>]</span></td></tr>
63 <!-- ==================== CLASS DESCRIPTION ==================== -->
64 <h1 class="epydoc">Class CommentBase</h1><p class="nomargin-top"></p>
65 <pre class="base-tree">
68 <a href="lxml.etree._Element-class.html" onclick="show_private();">_Element</a> --+
70 <a href="lxml.etree.__ContentOnlyElement-class.html" onclick="show_private();">__ContentOnlyElement</a> --+
72 <a href="lxml.etree._Comment-class.html" onclick="show_private();">_Comment</a> --+
74 <strong class="uidshort">CommentBase</strong>
77 <dl><dt>Known Subclasses:</dt>
79 <ul class="subclass-list">
80 <li class="private"><a href="lxml.html.HtmlComment-class.html" onclick="show_private();">html.HtmlComment</a></li> </ul>
84 <p>All custom Comment classes must inherit from this one.</p>
85 <p>To create an XML Comment instance, use the <tt class="rst-docutils literal">Comment()</tt> factory.</p>
86 <p>Subclasses <em>must not</em> override __init__ or __new__ as it is
87 absolutely undefined when these objects will be created or
88 destroyed. All persistent state of Comments must be stored in the
89 underlying XML. If you really need to initialize the object after
90 creation, you can implement an <tt class="rst-docutils literal">_init(self)</tt> method that will be
91 called after object creation.</p>
93 <!-- ==================== INSTANCE METHODS ==================== -->
94 <a name="section-InstanceMethods"></a>
95 <table class="summary" border="1" cellpadding="3"
96 cellspacing="0" width="100%" bgcolor="white">
97 <tr bgcolor="#70b0f0" class="table-header">
98 <td colspan="2" class="table-header">
99 <table border="0" cellpadding="0" cellspacing="0" width="100%">
101 <td align="left"><span class="table-header">Instance Methods</span></td>
102 <td align="right" valign="top"
103 ><span class="options">[<a href="#section-InstanceMethods"
104 class="privatelink" onclick="toggle_private();"
105 >hide private</a>]</span></td>
111 <td width="15%" align="right" valign="top" class="summary">
112 <span class="summary-type"> </span>
113 </td><td class="summary">
114 <table width="100%" cellpadding="0" cellspacing="0" border="0">
116 <td><span class="summary-sig"><a href="lxml.etree.CommentBase-class.html#__init__" class="summary-sig-name">__init__</a>(<span class="summary-sig-arg">...</span>)</span><br />
117 x.__init__(...) initializes x; see help(type(x)) for signature</td>
118 <td align="right" valign="top">
128 <td width="15%" align="right" valign="top" class="summary">
129 <span class="summary-type">a new object with type S, a subtype of T</span>
130 </td><td class="summary">
131 <table width="100%" cellpadding="0" cellspacing="0" border="0">
133 <td><span class="summary-sig"><a href="lxml.etree.CommentBase-class.html#__new__" class="summary-sig-name">__new__</a>(<span class="summary-sig-arg">T</span>,
134 <span class="summary-sig-arg">S</span>,
135 <span class="summary-sig-arg">...</span>)</span></td>
136 <td align="right" valign="top">
146 <td colspan="2" class="summary">
147 <p class="indent-wrapped-lines"><b>Inherited from <code><a href="lxml.etree._Comment-class.html" onclick="show_private();">_Comment</a></code></b>:
148 <code><a href="lxml.etree._Comment-class.html#__repr__">__repr__</a></code>
150 <p class="indent-wrapped-lines"><b>Inherited from <code><a href="lxml.etree.__ContentOnlyElement-class.html" onclick="show_private();">__ContentOnlyElement</a></code></b>:
151 <code><a href="lxml.etree.__ContentOnlyElement-class.html#__delitem__">__delitem__</a></code>,
152 <code><a href="lxml.etree.__ContentOnlyElement-class.html#__getitem__">__getitem__</a></code>,
153 <code><a href="lxml.etree.__ContentOnlyElement-class.html#__len__">__len__</a></code>,
154 <code><a href="lxml.etree.__ContentOnlyElement-class.html#__setitem__">__setitem__</a></code>,
155 <code><a href="lxml.etree.__ContentOnlyElement-class.html#append">append</a></code>,
156 <code><a href="lxml.etree.__ContentOnlyElement-class.html#get">get</a></code>,
157 <code><a href="lxml.etree.__ContentOnlyElement-class.html#insert">insert</a></code>,
158 <code><a href="lxml.etree.__ContentOnlyElement-class.html#items">items</a></code>,
159 <code><a href="lxml.etree.__ContentOnlyElement-class.html#keys">keys</a></code>,
160 <code><a href="lxml.etree.__ContentOnlyElement-class.html#set">set</a></code>,
161 <code><a href="lxml.etree.__ContentOnlyElement-class.html#values">values</a></code>
163 <p class="indent-wrapped-lines"><b>Inherited from <code><a href="lxml.etree._Element-class.html" onclick="show_private();">_Element</a></code></b>:
164 <code><a href="lxml.etree._Element-class.html#__contains__">__contains__</a></code>,
165 <code><a href="lxml.etree._Element-class.html#__copy__">__copy__</a></code>,
166 <code><a href="lxml.etree._Element-class.html#__deepcopy__">__deepcopy__</a></code>,
167 <code><a href="lxml.etree._Element-class.html#__iter__">__iter__</a></code>,
168 <code><a href="lxml.etree._Element-class.html#__nonzero__">__nonzero__</a></code>,
169 <code><a href="lxml.etree._Element-class.html#__reversed__">__reversed__</a></code>,
170 <code><a href="lxml.etree._Element-class.html#addnext">addnext</a></code>,
171 <code><a href="lxml.etree._Element-class.html#addprevious">addprevious</a></code>,
172 <code><a href="lxml.etree._Element-class.html#clear">clear</a></code>,
173 <code><a href="lxml.etree._Element-class.html#extend">extend</a></code>,
174 <code><a href="lxml.etree._Element-class.html#find">find</a></code>,
175 <code><a href="lxml.etree._Element-class.html#findall">findall</a></code>,
176 <code><a href="lxml.etree._Element-class.html#findtext">findtext</a></code>,
177 <code><a href="lxml.etree._Element-class.html#getchildren">getchildren</a></code>,
178 <code><a href="lxml.etree._Element-class.html#getiterator">getiterator</a></code>,
179 <code><a href="lxml.etree._Element-class.html#getnext">getnext</a></code>,
180 <code><a href="lxml.etree._Element-class.html#getparent">getparent</a></code>,
181 <code><a href="lxml.etree._Element-class.html#getprevious">getprevious</a></code>,
182 <code><a href="lxml.etree._Element-class.html#getroottree">getroottree</a></code>,
183 <code><a href="lxml.etree._Element-class.html#index">index</a></code>,
184 <code><a href="lxml.etree._Element-class.html#iter">iter</a></code>,
185 <code><a href="lxml.etree._Element-class.html#iterancestors">iterancestors</a></code>,
186 <code><a href="lxml.etree._Element-class.html#iterchildren">iterchildren</a></code>,
187 <code><a href="lxml.etree._Element-class.html#iterdescendants">iterdescendants</a></code>,
188 <code><a href="lxml.etree._Element-class.html#iterfind">iterfind</a></code>,
189 <code><a href="lxml.etree._Element-class.html#itersiblings">itersiblings</a></code>,
190 <code><a href="lxml.etree._Element-class.html#itertext">itertext</a></code>,
191 <code><a href="lxml.etree._Element-class.html#makeelement">makeelement</a></code>,
192 <code><a href="lxml.etree._Element-class.html#remove">remove</a></code>,
193 <code><a href="lxml.etree._Element-class.html#replace">replace</a></code>,
194 <code><a href="lxml.etree._Element-class.html#xpath">xpath</a></code>
196 <div class="private"> <p class="indent-wrapped-lines"><b>Inherited from <code><a href="lxml.etree._Element-class.html" onclick="show_private();">_Element</a></code></b> (private):
197 <code><a href="lxml.etree._Element-class.html#_init" onclick="show_private();">_init</a></code>
199 <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>:
200 <code>__delattr__</code>,
201 <code>__format__</code>,
202 <code>__getattribute__</code>,
203 <code>__hash__</code>,
204 <code>__reduce__</code>,
205 <code>__reduce_ex__</code>,
206 <code>__setattr__</code>,
207 <code>__sizeof__</code>,
208 <code>__str__</code>,
209 <code>__subclasshook__</code>
214 <!-- ==================== PROPERTIES ==================== -->
215 <a name="section-Properties"></a>
216 <table class="summary" border="1" cellpadding="3"
217 cellspacing="0" width="100%" bgcolor="white">
218 <tr bgcolor="#70b0f0" class="table-header">
219 <td colspan="2" class="table-header">
220 <table border="0" cellpadding="0" cellspacing="0" width="100%">
222 <td align="left"><span class="table-header">Properties</span></td>
223 <td align="right" valign="top"
224 ><span class="options">[<a href="#section-Properties"
225 class="privatelink" onclick="toggle_private();"
226 >hide private</a>]</span></td>
232 <td colspan="2" class="summary">
233 <p class="indent-wrapped-lines"><b>Inherited from <code><a href="lxml.etree._Comment-class.html" onclick="show_private();">_Comment</a></code></b>:
234 <code><a href="lxml.etree._Comment-class.html#tag">tag</a></code>
236 <p class="indent-wrapped-lines"><b>Inherited from <code><a href="lxml.etree.__ContentOnlyElement-class.html" onclick="show_private();">__ContentOnlyElement</a></code></b>:
237 <code><a href="lxml.etree.__ContentOnlyElement-class.html#attrib">attrib</a></code>,
238 <code><a href="lxml.etree.__ContentOnlyElement-class.html#text">text</a></code>
240 <p class="indent-wrapped-lines"><b>Inherited from <code><a href="lxml.etree._Element-class.html" onclick="show_private();">_Element</a></code></b>:
241 <code><a href="lxml.etree._Element-class.html#base">base</a></code>,
242 <code><a href="lxml.etree._Element-class.html#nsmap">nsmap</a></code>,
243 <code><a href="lxml.etree._Element-class.html#prefix">prefix</a></code>,
244 <code><a href="lxml.etree._Element-class.html#sourceline">sourceline</a></code>,
245 <code><a href="lxml.etree._Element-class.html#tail">tail</a></code>
247 <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>:
248 <code>__class__</code>
253 <!-- ==================== METHOD DETAILS ==================== -->
254 <a name="section-MethodDetails"></a>
255 <table class="details" border="1" cellpadding="3"
256 cellspacing="0" width="100%" bgcolor="white">
257 <tr bgcolor="#70b0f0" class="table-header">
258 <td colspan="2" class="table-header">
259 <table border="0" cellpadding="0" cellspacing="0" width="100%">
261 <td align="left"><span class="table-header">Method Details</span></td>
262 <td align="right" valign="top"
263 ><span class="options">[<a href="#section-MethodDetails"
264 class="privatelink" onclick="toggle_private();"
265 >hide private</a>]</span></td>
271 <a name="__init__"></a>
273 <table class="details" border="1" cellpadding="3"
274 cellspacing="0" width="100%" bgcolor="white">
276 <table width="100%" cellpadding="0" cellspacing="0" border="0">
277 <tr valign="top"><td>
278 <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<span class="sig-arg">...</span>)</span>
279 <br /><em class="fname">(Constructor)</em>
281 </td><td align="right" valign="top"
286 x.__init__(...) initializes x; see help(type(x)) for signature
294 <a name="__new__"></a>
296 <table class="details" border="1" cellpadding="3"
297 cellspacing="0" width="100%" bgcolor="white">
299 <table width="100%" cellpadding="0" cellspacing="0" border="0">
300 <tr valign="top"><td>
301 <h3 class="epydoc"><span class="sig"><span class="sig-name">__new__</span>(<span class="sig-arg">T</span>,
302 <span class="sig-arg">S</span>,
303 <span class="sig-arg">...</span>)</span>
305 </td><td align="right" valign="top"
312 <dt>Returns: a new object with type S, a subtype of T</dt>
320 <!-- ==================== NAVIGATION BAR ==================== -->
321 <table class="navbar" border="0" width="100%" cellpadding="0"
322 bgcolor="#a0c0ff" cellspacing="0">
325 <th> <a
326 href="lxml-module.html">Home</a> </th>
329 <th> <a
330 href="module-tree.html">Trees</a> </th>
333 <th> <a
334 href="identifier-index.html">Indices</a> </th>
337 <th> <a
338 href="help.html">Help</a> </th>
340 <!-- Project homepage -->
341 <th class="navbar" align="right" width="100%">
342 <table border="0" cellpadding="0" cellspacing="0">
343 <tr><th class="navbar" align="center"
344 ><a class="navbar" target="_top" href="/">lxml API</a></th>
348 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
350 <td align="left" class="footer">
351 Generated by Epydoc 3.0.1 on Tue Jul 31 10:14:18 2012
353 <td align="right" class="footer">
354 <a target="mainFrame" href="http://epydoc.sourceforge.net"
355 >http://epydoc.sourceforge.net</a>
360 <script type="text/javascript">
362 // Private objects are initially displayed (because if
363 // javascript is turned off then we want them to be
364 // visible); but by default, we want to hide them. So hide
365 // them unless we have a cookie that says to show them.